SHADOWS SDK.
Build art, memes, games, explorers, and agent integrations with onchain Shadow sprites and data.
- SPRITESRender animated onchain pixel art as SVG or canvas data in the Shadow and Light realms.
- COLLECTIONRead ownership, traits, and token-bound Shadow Wallet addresses.
- AGENTSRead ERC-8004 profiles and verify their bindings to the collection.
QUICK START
Install the GitHub release in a project using Node.js 20 or later.
npm install https://github.com/gotchishadows/sdk/releases/download/v0.1.1/gotchishadows-sdk-0.1.1.tgz
Read Shadow #5471 from an ES module.
import {createShadowClient} from '@gotchishadows/sdk';
const shadows = createShadowClient();
const shadow = await shadows.getShadow(5471);
console.log(shadow.owner, shadow.wallet, shadow.metadata.attributes);
v0.1.1 is read-only and released under the MIT License.
SHADOWY APIS
Use these read-only JSON endpoints directly from your server. Requests use GET and require no API key.
/api/shadows?action=state- Collection state, supply, and the block used for the read.
/api/shadows?action=token&id=5471- A Shadow’s owner, token-bound wallet, and onchain metadata.
/api/shadows?action=cards&ids=5471,24- Card data for up to six distinct Shadow IDs.
/api/profile?address=YOUR_WALLET&page=1- Paginated Shadows owned by an EVM wallet. Replace
YOUR_WALLETwith its address.
curl 'https://gotchishadows.com/api/shadows?action=token&id=5471'
If your app runs on a different domain, call these endpoints from its backend. The SDK also provides direct onchain reads for ERC-8004 agent profiles.