Skip to content

Repository files navigation

Stamp codecov

Resolve and resize web3 avatar and token images.

Usage

Simply use a valid Stamp URL to display an avatar:

https://cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7?s=200

<img src="https://cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7?s=200" />

URL structure

cdn.stamp.fyi/{type}/{identifier}?{params}
cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7?s=200

Type

The type is either avatar or token.

Examples

cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7
cdn.stamp.fyi/token/0x0bc529c00C6401aEF6D220BE8C6Ea1667F6Ad93e

Identifier

The identifier can be an address (case insensitive), ENS name, Basename, CAIP-10, EIP-3770, DID or Starknet domain.

Examples

cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7
cdn.stamp.fyi/avatar/fabien.eth
cdn.stamp.fyi/avatar/jesse.base.eth
cdn.stamp.fyi/token/eth:0x0bc529c00C6401aEF6D220BE8C6Ea1667F6Ad93e
cdn.stamp.fyi/token/eip155:1:0x0bc529c00C6401aEF6D220BE8C6Ea1667F6Ad93e cdn.stamp.fyi/avatar/checkpoint.stark cdn.stamp.fyi/avatar/0x07FF6B17f07c4d83236E3Fc5f94259A19D1Ed41bBCf1822397EA17882E9b038d

Params

With the params you can define the size of the image returned. You can also refresh the image cache using cb param.

Examples

cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7?s=160 cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7?w=160&h=240 cdn.stamp.fyi/avatar/0xeF8305E140ac520225DAf050e2f71d5fBcC543e7?cb=1

Resolvers

Resolves the avatar of a Basename (*.base.eth) by name or by address, reading the avatar text record from the Basenames L2 resolver on Base.

Integrations

License

MIT.

About

Avatars for web3

Resources

Stars

87 stars

Watchers

4 watching

Forks

Used by

Contributors

Languages