Skip to main content

The DIG SDK

@dignetwork/dig-sdk is the typed npm package for integrating developers. It unifies one wallet surface over two transports, reads verified content, monetizes access, and re-exports the canonical spend builder — so you wire DIG into your app without scraping prose or hand-rolling a spend.

npm i @dignetwork/dig-sdk
npm i @walletconnect/sign-client   # optional: only for the WalletConnect fallback

What's in it​

ExportSubpathWhat it does
ChiaProvider@dignetwork/dig-sdkOne wallet API; prefers injected window.chia, falls back to WalletConnect → Sage
DigClient@dignetwork/dig-sdkReads verified, encrypted content over the dig RPC — verify-then-decrypt, client-side
Paywall@dignetwork/dig-sdkHigh-level pay-to-unlock / NFT-or-collection ownership gating
canonical CHIP-0035 spend builder@dignetwork/dig-sdk/spendThe wasm that builds every coin spend — never hand-rolled

ChiaProvider — connect a wallet​

import { ChiaProvider } from "@dignetwork/dig-sdk";

// "auto" prefers the injected DIG Browser wallet, else WalletConnect → Sage.
const provider = await ChiaProvider.connect({ mode: "auto" });
const address = await provider.getAddress();
// provider.backend tells you which transport connected.

One connect() works in the DIG Browser (no QR, no relay) and everywhere else (WalletConnect). The method names and result shapes are identical either way; the exact contract is the normative window.chia provider spec.

Offer a chooser instead of auto-picking​

mode: "auto" above silently prefers the injected wallet — fine for a single-wallet-target app, but a user who has both a Browser Wallet and Sage should get to pick. ChiaProvider.listConnectors() enumerates the connectors a chooser UI can offer, without connecting to either:

import { ChiaProvider } from "@dignetwork/dig-sdk";

const connectors = ChiaProvider.listConnectors();
// [{ id: "browser-wallet", backend: "injected", label: "Browser Wallet", available }, 
//  { id: "walletconnect", backend: "walletconnect", label: "WalletConnect", available: true }]

// render one button per connector (disable any with available: false), then:
const provider = await ChiaProvider.connect({ mode: chosenConnector.id, walletConnect });

"browser-wallet" is an alias of "injected" — pass the picked connector's id straight through as mode.

DigClient — read verified content​

import { DigClient } from "@dignetwork/dig-sdk";

const dig = new DigClient();                 // resolves a node automatically; pass endpoint to override
const html = await dig.readText({
  urn: "urn:dig:chia:<storeId>/index.html",
  root: "<onchain-root-hex>",                 // the trust anchor, read from the chain
});

DigClient accepts an endpoint constructor option to point at a specific node; left unset, it resolves one automatically — preferring a reachable local dig-node (dig.local, then localhost) and falling back to the public gateway https://rpc.dig.net only when neither answers. Pointing at a local node changes where ciphertext is fetched, never whether it's trusted: it derives the URN's keys in the browser, verifies inclusion against the on-chain root, and decrypts — the serving host stays blind. → What is the dig RPC?

Paywall — monetize & gate​

import { ChiaProvider, Paywall } from "@dignetwork/dig-sdk";

const provider = await ChiaProvider.connect({ mode: "auto" });
const paywall = new Paywall({ provider });

const receipt = await paywall.requestPayment({ amount: 5, owner: "<your-address>" });
if (await paywall.verifyReceipt(receipt)) { /* unlock the content */ }

// or gate on ownership instead of payment:
await paywall.proveAccess({ collection: "<collection-id>" });

Paywall composes a connected ChiaProvider with the spend builder so you don't wire payments by hand.

capabilities()​

ChiaProvider exposes capabilities() so you can introspect which methods and transports are available before you call them — discover, don't assume.

/spend — the canonical builder​

The CHIP-0035 wasm is re-exported at the /spend subpath. Never hand-roll a spend bundle — see Building spends.