@shared-db/sdk

Early preview — Base Sepolia testnet only. Mainnet is Phase 4.

SDK for Shared Database: a public, permissionless read/write data layer on Base. Think "localStorage that works across every app, every device, forever."

Full reference (config, API, examples): https://shared-database.vercel.app/llms.txt

Install

npm install @shared-db/sdk viem

Quick start

import { SharedDB } from '@shared-db/sdk';

const db = new SharedDB({
  rpcUrl:          'https://base-sepolia.infura.io/v3/YOUR_KEY',
  contractAddress: '0x3f0b7e8fA36417Fa922ad1AE36e0b1D053D48af3',
  privateKey:      '0xYOUR_PRIVATE_KEY',
});

// Write
await db.collection('my-app').write({ hello: 'world' });

// Read (queries the hosted indexer — no setup required)
const rows = await db.collection('my-app').query();
console.log(rows.map(r => r.data));

indexerUrl defaults to the hosted indexer — no configuration needed for reads.

Contract

0x3f0b7e8fA36417Fa922ad1AE36e0b1D053D48af3 on Base Sepolia (chainId 84532)

License

MIT