@adspacedotfun/sdk

Official SDK for embedding AdSpace.fun blockchain-powered advertisements.

Structure

src/
├── index.ts          # Main entry (vanilla JS)
├── react.ts          # React entry
├── vue.ts            # Vue entry
│
├── core/             # Framework-agnostic core
│   ├── client.ts     # AdSpaceClient - main SDK class
│   ├── config.ts     # Configuration types & defaults
│   ├── contracts.ts  # Contract ABIs
│   ├── types.ts      # TypeScript interfaces
│   └── utils/        # IPFS & campaign helpers
│
├── react/            # React integration
│   ├── context.tsx   # AdSpaceProvider
│   ├── hooks/        # useActiveAd hook
│   └── components/   # AdWidget component
│
└── vue/              # Vue integration
    ├── plugin.ts     # Vue plugin
    ├── composables/  # useActiveAd composable
    └── components/   # AdWidget component

How It Works

1. AdSpaceClient connects to the blockchain via JSON-RPC
2. Calls getActiveAdImage(spaceId) on the AdSpaceManager contract
3. Returns active campaign image (or default ad if none active)
4. IPFS URLs are resolved to HTTP gateway URLs
5. Framework integrations provide auto-refresh polling

Build

npm install
npm run build

Outputs ESM, CJS, and TypeScript declarations to dist/.

Publish

npm publish --access public