Skip to content
@blocktrails

blocktrails

Blocktrails

Nostr-native state on Bitcoin.

Blocktrails are a primitive for anchoring evolving state to Bitcoin using output-key commitments. One P2TR output per state update. No extra tokens. No sidechains.

Get Started

Resource Description
blocktrails.org Landing page — start here
Specification Full technical spec
Reference Implementation JavaScript/Node.js library

Quick Example

import { Blocktrail } from 'blocktrails';

const trail = new Blocktrail(privateKey);
trail.genesis(JSON.stringify({ balance: 1000 }));
trail.advance(JSON.stringify({ balance: 900 }));

// Each state → unique P2TR address on Bitcoin

Key Properties

  • Nostr-native — full secp256k1 keys, same as Nostr
  • Minimal — one output per state, key-path spends only
  • SPV-compatible — verify with merkle proofs
  • No extra tokens — just Bitcoin

Status

  • Specification: draft
  • Reference implementation: v0.1.0

License

Public domain.

Popular repositories Loading

  1. blocktrails-archive blocktrails-archive Public

    blocktrails

    2

  2. blocktrails blocktrails Public

    Reference implementation of Blocktrails

    JavaScript 2

  3. 402 402 Public

    HTTP 402 Payment Required specification with NIP-98 authentication

    2

  4. blocktrails.github.io blocktrails.github.io Public

    Blocktrails landing page

    HTML 1

  5. spec spec Public

    Blocktrails specification

    HTML 1

  6. demo demo Public

    Live Blocktrails demo on Bitcoin testnet4

    HTML 1

Repositories

Showing 10 of 13 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…