Build on 1Sat Ordinals

Everything you need to create tokens, NFTs, and applications on Bitcoin SV

1Sat SDK Use-Case Matrix

Pick packages by app surface. These are reference snippets for builders and are not wired into this website runtime.

Source repository: github.com/b-open-io/1sat-sdk

@1sat/connect

Browser dApps that need wallet connect/sign flows.

Install

bun add @1sat/connect

Example

import { createOneSat } from "@1sat/connect";

const onesat = createOneSat({ appName: "My dApp" });
await onesat.connect();

@1sat/react

React apps using provider/hooks/components.

Install

bun add @1sat/react

Example

import { ConnectButton, OneSatProvider } from "@1sat/react";

<OneSatProvider appName="My App">
  <ConnectButton />
</OneSatProvider>;

@1sat/actions + @1sat/client + @1sat/types

Server scripts, transaction building, and service clients.

Install

bun add @1sat/actions @1sat/client @1sat/types

Example

import { createOrdinals, fetchPayUtxos } from "@1sat/actions";
import { ArcadeClient } from "@1sat/client";
import { ONESAT_MAINNET_URL } from "@1sat/types";

@1sat/wallet-browser + @1sat/wallet-node

BRC-100 wallet engine factories for browser/node.

Install

bun add @1sat/wallet-browser @1sat/wallet-node

Example

import { createNodeWallet } from "@1sat/wallet-node";

const { wallet } = await createNodeWallet({
  rootKey: process.env.ROOT_KEY!,
  chain: "main",
  dbFilename: "wallet.sqlite",
});

1Sat CLI

A terminal wallet for 1Sat Ordinals with 30+ commands for wallets, ordinals, BSV21 tokens, and identity. Requires the Bun runtime. The installed binary is named 1sat.

Package: @1sat/cli · Source: github.com/b-open-io/1sat-sdk

Install

Run instantly (no install)

bunx @1sat/cli

Global install (recommended)

bun add -g @1sat/cli

Common commands

# First-time setup (generate or import a key)
1sat init

# Wallet
1sat wallet balance
1sat wallet send --to <addr> --sats <amount>

# Ordinals
1sat ordinals list
1sat ordinals mint --file image.png

# BSV21 tokens
1sat tokens balances

Claude Code Agent Skills

The 1Sat ecosystem ships Agent Skills that teach Claude Code (and other AI coding tools) how to build on 1Sat Ordinals — minting, the marketplace, token operations, wallet setup, transaction building, and more. They are distributed as the 1sat plugin in the b-open-io marketplace.

Install the plugin (Claude Code)

Add the marketplace, then install

/plugin marketplace add b-open-io/claude-plugins
/plugin install 1sat@b-open-io

Or, one-line CLI

claude plugin install 1sat@b-open-io

Once installed, just ask Claude Code to perform a task (e.g. "mint an ordinal" or "list this NFT on the marketplace") and the matching skill loads automatically.

Use individual skills (any AI tool)

Skills live in the SDK repo and can be added one at a time:

npx skills add b-open-io/1sat-sdk \
  --skill cli

Browse them all in the SDK skills directory: github.com/b-open-io/1sat-sdk

Available skills

  • cli

    1Sat CLI usage and its 30+ commands.

  • stack-api

    Unified BSV indexing API (1sat-stack / api.1sat.app).

  • dapp-connect

    Wallet popup + React hooks for browser dApps.

  • ordinals-create

    Mint and inscribe ordinals / NFTs.

  • ordinals-marketplace

    List, buy, and cancel OrdLock listings.

  • tokens

    BSV20 / BSV21 fungible token operations.

  • action-patterns

    Transaction building with BRC-100 actions.

  • wallet-setup

    BRC-100 wallet setup, storage, and sync.

  • payments

    Send BSV and build payment flows.

  • signing

    BSM message signing and Sigma attestation.

  • locks

    Time-lock BSV until a target block height.

  • sweep

    Sweep / import funds from an external WIF.

  • opns

    OpNS on-chain name registration.

  • blockchain-media

    Extract inscribed media from the blockchain.

Protocol & Library References

Reference links carried forward from the current live ecosystem resources so builders can find the same protocol and tooling surfaces after cutover.

Protocol Specs

  • BSV20

    Fungible token specification on 1Sat Ordinals.

  • BSV21

    Enhanced fungible token model for advanced use cases.

  • POW20

    POW20 protocol reference and documentation.

  • MAP

    Magic Attribute Protocol for structured metadata.

  • Sigma Identity

    Cryptographic identity and auth primitives.

  • AIP

    Author Identity Protocol reference implementation.

GitHub Libraries

Quick Start

1. Read the Documentation

Start with the protocol specification at docs.1satordinals.com to understand how 1Sat Ordinals work.

2. Explore the Ecosystem

Check out existing projects and tools on the Projects page to see what's possible.

3. Join the Community

Connect with other developers in Discord to get help and share your work.

4. Start Building

Use the SDK matrix above to choose the right package for your app surface.