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/core + @1sat/client + @1sat/types

Server scripts, transaction building, and service clients.

Install

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

Example

import { createOrdinals } from "@1sat/core";
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",
});

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.

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.