SHADOWS / DEVELOPER TOOLS

SHADOWS SDK.

Build art, memes, games, explorers, and agent integrations with onchain Shadow sprites and data.

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_WALLET with 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.

↑