digirails 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DigiRails Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,102 @@
+# digirails
+
+Node.js/TypeScript SDK for the [DR-Pay protocol](https://github.com/digirails-protocol/digirails-spec) — permissionless AI agent payments on DigiByte.
+
+## What is this?
+
+DigiRails enables autonomous AI agents to discover, negotiate with, and pay each other using DigiByte's Layer 1 blockchain. This SDK implements the DR-Pay protocol: the 4-message payment flow, agent identity, service manifests, and on-chain data encoding.
+
+Every payment settles on-chain as a standard DigiByte transaction. No sidechains, no Layer 2, no API keys.
+
+## Install
+
+```bash
+npm install digirails
+```
+
+## Quick Start
+
+### Buyer — purchase a service in one call
+
+```typescript
+import { Agent, REGTEST } from 'digirails';
+
+const buyer = Agent.generate({
+  network: REGTEST,
+  rpcUrl: 'http://127.0.0.1:18443',
+  rpcUsername: 'digirails',
+  rpcPassword: 'digirails',
+});
+
+const result = await buyer.requestService({
+  sellerUrl: 'http://127.0.0.1:9001',
+  serviceId: 'echo',
+  serviceParams: { message: 'Hello from DigiRails!' },
+  maxAmount: '0.01',
+});
+console.log(result.result);
+
+await buyer.close();
+```
+
+### Seller — offer a service
+
+```typescript
+import { Agent, ServiceCategory, REGTEST } from 'digirails';
+
+const seller = Agent.generate({
+  network: REGTEST,
+  rpcUrl: 'http://127.0.0.1:18443',
+  rpcUsername: 'digirails',
+  rpcPassword: 'digirails',
+});
+
+seller.registerService({
+  serviceId: 'echo',
+  handler: async (params) => ({ echo: params?.message ?? '' }),
+  price: '0.001',
+  category: ServiceCategory.GENERAL_COMPUTE,
+});
+
+await seller.serve('0.0.0.0', 9001);
+```
+
+## What happens under the hood
+
+```
+Buyer                                Seller
+  |                                    |
+  |  GET /.well-known/digirails.json   |
+  |----------------------------------->|  1. Discover manifest
+  |<-----------------------------------|
+  |                                    |
+  |  POST /drpay/request               |
+  |----------------------------------->|  2. SERVICE_REQUEST
+  |<-----------------------------------|  3. PAYMENT_INVOICE
+  |                                    |
+  |  [build, sign, broadcast tx]       |
+  |                                    |
+  |  POST /drpay/broadcast             |
+  |----------------------------------->|  4. PAYMENT_BROADCAST
+  |                                    |  5. Verify payment
+  |                                    |  6. Execute service
+  |<-----------------------------------|  7. SERVICE_DELIVERY
+```
+
+## Features
+
+- **Light mode**: No DigiByte node required. Connects to `rpc.digirails.org` or any RPC endpoint.
+- **Async-native**: Built on native `fetch` and `async/await`.
+- **Type-safe**: Zod-validated protocol messages with full TypeScript types.
+- **3 dependencies**: @noble/curves, @noble/hashes, zod. Zero native modules.
+- **SegWit transactions**: BIP-143 signing for P2WPKH inputs.
+- **Encrypted keystore**: AES-256-GCM encrypted key files.
+- **All 18 service categories** from the DR-Pay spec.
+
+## Protocol Version
+
+Implements DR-Pay specification v0.3.0.
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,72 @@
+import { Wallet } from './wallet/wallet';
+import { RpcClient } from './rpc/client';
+import { ServiceHandler } from './payment/seller';
+import { Manifest } from './models/manifest';
+import { ConfirmationTier, ServiceCategory } from './models/enums';
+import { ServiceDelivery } from './models/messages';
+import { DigiRailsConfig } from './config';
+import { NetworkParams } from './network/params';
+export declare class Agent {
+    private wallet;
+    private rpc;
+    private sellerFlow;
+    private server;
+    private config;
+    private _services;
+    private constructor();
+    /**
+     * Create an Agent from a config or individual params.
+     */
+    static create(params: {
+        config?: Partial<DigiRailsConfig>;
+        network?: NetworkParams;
+        privateKey?: string | Buffer;
+        rpcUrl?: string;
+        rpcUsername?: string;
+        rpcPassword?: string;
+    }): Agent;
+    /** Generate a fresh agent with a new keypair */
+    static generate(params?: {
+        network?: NetworkParams;
+        rpcUrl?: string;
+        rpcUsername?: string;
+        rpcPassword?: string;
+    }): Agent;
+    /** Agent's DigiByte address */
+    get address(): string;
+    /** Agent's compressed public key */
+    get publicKey(): Buffer;
+    /** Access the underlying wallet */
+    getWallet(): Wallet;
+    /** Access the RPC client */
+    getRpc(): RpcClient | null;
+    /**
+     * Request and pay for a service in one call.
+     * Set test=true to mark the on-chain OP_RETURN with the test flag.
+     */
+    requestService(params: {
+        sellerUrl: string;
+        serviceId: string;
+        serviceParams?: Record<string, unknown>;
+        maxAmount?: string;
+        confirmationTier?: ConfirmationTier;
+        test?: boolean;
+    }): Promise<ServiceDelivery>;
+    /** Fetch and validate a seller's manifest */
+    discover(url: string): Promise<Manifest | null>;
+    /** Register a service handler */
+    registerService(params: {
+        serviceId: string;
+        handler: ServiceHandler;
+        price: string;
+        description?: string;
+        category?: ServiceCategory;
+    }): void;
+    /** Start serving registered services via HTTP */
+    serve(host?: string, port?: number): Promise<void>;
+    /** Get wallet balance in DGB */
+    balance(): Promise<string>;
+    /** Close the agent and release resources */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAc,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAI9D,OAAO,EAAE,QAAQ,EAAW,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAiB,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAW,MAAM,kBAAkB,CAAC;AAE1D,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAiB;IAElC,OAAO;IAMP;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,KAAK;IAqCT,gDAAgD;IAChD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;QACvB,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,KAAK;IAYT,+BAA+B;IAC/B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,oCAAoC;IACpC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,mCAAmC;IACnC,SAAS,IAAI,MAAM;IAInB,4BAA4B;IAC5B,MAAM,IAAI,SAAS,GAAG,IAAI;IAM1B;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxC,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;QACpC,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,eAAe,CAAC;IAY5B,6CAA6C;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAUrD,iCAAiC;IACjC,eAAe,CAAC,MAAM,EAAE;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,cAAc,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B,GAAG,IAAI;IAyBR,iDAAiD;IAC3C,KAAK,CAAC,IAAI,SAAY,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBzD,gCAAgC;IAC1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAMhC,4CAA4C;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/agent.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+/**
+ * Agent: unified high-level API for DigiRails.
+ * Combines wallet, RPC, payment flow, and server into a single interface.
+ */
+const keys_1 = require("./crypto/keys");
+const keys_2 = require("./crypto/keys");
+const wallet_1 = require("./wallet/wallet");
+const client_1 = require("./rpc/client");
+const seller_1 = require("./payment/seller");
+const server_1 = require("./server");
+const manifest_client_1 = require("./discovery/manifest_client");
+const flow_1 = require("./payment/flow");
+const config_1 = require("./config");
+const params_1 = require("./network/params");
+class Agent {
+    wallet;
+    rpc;
+    sellerFlow = null;
+    server = null;
+    config;
+    _services = [];
+    constructor(wallet, config, rpc) {
+        this.wallet = wallet;
+        this.config = config;
+        this.rpc = rpc;
+    }
+    /**
+     * Create an Agent from a config or individual params.
+     */
+    static create(params) {
+        const cfg = (0, config_1.defaultConfig)(params.config);
+        if (params.network)
+            cfg.network = params.network;
+        // Resolve private key
+        let privkey;
+        const pk = params.privateKey ?? cfg.privateKey;
+        if (!pk) {
+            throw new Error('No private key provided');
+        }
+        if (Buffer.isBuffer(pk)) {
+            privkey = pk;
+        }
+        else if (typeof pk === 'string') {
+            if (pk.length === 64) {
+                // Hex
+                privkey = Buffer.from(pk, 'hex');
+            }
+            else {
+                // WIF
+                const [key] = (0, keys_2.wifToPrivkey)(pk);
+                privkey = key;
+            }
+        }
+        else {
+            throw new Error('Invalid private key format');
+        }
+        // RPC client
+        const rpcUrl = params.rpcUrl ?? cfg.rpcUrl ?? cfg.network.defaultRpcUrl;
+        const rpc = new client_1.RpcClient(rpcUrl, params.rpcUsername ?? cfg.rpcUsername, params.rpcPassword ?? cfg.rpcPassword);
+        const wallet = new wallet_1.Wallet(privkey, cfg.network, rpc);
+        return new Agent(wallet, cfg, rpc);
+    }
+    /** Generate a fresh agent with a new keypair */
+    static generate(params) {
+        const network = params?.network ?? params_1.MAINNET;
+        const [privkey] = (0, keys_1.generateKeypair)(network);
+        return Agent.create({
+            network,
+            privateKey: privkey,
+            rpcUrl: params?.rpcUrl,
+            rpcUsername: params?.rpcUsername,
+            rpcPassword: params?.rpcPassword,
+        });
+    }
+    /** Agent's DigiByte address */
+    get address() {
+        return this.wallet.address;
+    }
+    /** Agent's compressed public key */
+    get publicKey() {
+        return this.wallet.publicKey;
+    }
+    /** Access the underlying wallet */
+    getWallet() {
+        return this.wallet;
+    }
+    /** Access the RPC client */
+    getRpc() {
+        return this.rpc;
+    }
+    // ---------- Buyer methods ----------
+    /**
+     * Request and pay for a service in one call.
+     * Set test=true to mark the on-chain OP_RETURN with the test flag.
+     */
+    async requestService(params) {
+        return (0, flow_1.buy)({
+            wallet: this.wallet,
+            sellerUrl: params.sellerUrl,
+            serviceId: params.serviceId,
+            serviceParams: params.serviceParams,
+            maxAmount: params.maxAmount,
+            confirmationTier: params.confirmationTier,
+            test: params.test,
+        });
+    }
+    /** Fetch and validate a seller's manifest */
+    async discover(url) {
+        try {
+            return await (0, manifest_client_1.fetchManifest)(url);
+        }
+        catch {
+            return null;
+        }
+    }
+    // ---------- Seller methods ----------
+    /** Register a service handler */
+    registerService(params) {
+        if (!this.sellerFlow) {
+            this.sellerFlow = new seller_1.SellerFlow(this.wallet, this.config.network, this.rpc ?? undefined);
+        }
+        const service = {
+            id: params.serviceId,
+            description: params.description ?? '',
+            pricing: {
+                model: 'per-request',
+                amount: params.price,
+                currency: 'DGB',
+            },
+            endpoint: `/drpay/request`,
+            payment: {
+                confirmations_required: 0,
+                max_invoice_age_seconds: 300,
+                streaming_supported: false,
+            },
+        };
+        this._services.push(service);
+        this.sellerFlow.registerService(service, params.handler);
+    }
+    /** Start serving registered services via HTTP */
+    async serve(host = '0.0.0.0', port = 8080) {
+        if (!this.sellerFlow) {
+            throw new Error('No services registered');
+        }
+        const manifest = {
+            drpay: '0.2.0',
+            agent: this.address,
+            address: this.address,
+            services: this._services,
+        };
+        this.server = new server_1.DigiRailsServer({
+            sellerFlow: this.sellerFlow,
+            manifest,
+            host,
+            port,
+        });
+        await this.server.start();
+    }
+    // ---------- Wallet methods ----------
+    /** Get wallet balance in DGB */
+    async balance() {
+        return this.wallet.balance();
+    }
+    // ---------- Lifecycle ----------
+    /** Close the agent and release resources */
+    async close() {
+        if (this.server) {
+            await this.server.stop();
+        }
+    }
+}
+exports.Agent = Agent;
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * DigiRails configuration management.
+ */
+import { NetworkParams } from './network/params';
+export interface DigiRailsConfig {
+    network: NetworkParams;
+    mode: 'light' | 'full';
+    rpcUrl?: string;
+    rpcUsername?: string;
+    rpcPassword?: string;
+    privateKey?: string;
+    keyfilePath?: string;
+    keyfilePassword?: string;
+    envKeyVar?: string;
+    spendingLimitPerTx: string;
+    spendingLimitPerHour: string;
+}
+/** Default configuration */
+export declare function defaultConfig(overrides?: Partial<DigiRailsConfig>): DigiRailsConfig;
+/** Create config from environment variables */
+export declare function configFromEnv(): DigiRailsConfig;
+/** Create regtest configuration */
+export declare function regtestConfig(overrides?: Partial<DigiRailsConfig>): DigiRailsConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAgC,MAAM,kBAAkB,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CAQvF;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,IAAI,eAAe,CAc/C;AAED,mCAAmC;AACnC,wBAAgB,aAAa,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,eAAe,CASvF"}

package/dist/config.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfig = defaultConfig;
+exports.configFromEnv = configFromEnv;
+exports.regtestConfig = regtestConfig;
+/**
+ * DigiRails configuration management.
+ */
+const params_1 = require("./network/params");
+/** Default configuration */
+function defaultConfig(overrides = {}) {
+    return {
+        network: params_1.MAINNET,
+        mode: 'light',
+        spendingLimitPerTx: '1.0',
+        spendingLimitPerHour: '100.0',
+        ...overrides,
+    };
+}
+/** Create config from environment variables */
+function configFromEnv() {
+    const networkName = process.env['DIGIRAILS_NETWORK'] ?? 'mainnet';
+    const network = (0, params_1.getNetwork)(networkName);
+    return {
+        network,
+        mode: process.env['DIGIRAILS_MODE'] ?? 'light',
+        rpcUrl: process.env['DIGIRAILS_RPC_URL'],
+        rpcUsername: process.env['DIGIRAILS_RPC_USER'],
+        rpcPassword: process.env['DIGIRAILS_RPC_PASS'],
+        privateKey: process.env['DIGIRAILS_PRIVATE_KEY'],
+        spendingLimitPerTx: '1.0',
+        spendingLimitPerHour: '100.0',
+    };
+}
+/** Create regtest configuration */
+function regtestConfig(overrides = {}) {
+    return {
+        network: params_1.REGTEST,
+        mode: 'full',
+        rpcUrl: 'http://127.0.0.1:18443',
+        spendingLimitPerTx: '1000.0',
+        spendingLimitPerHour: '10000.0',
+        ...overrides,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAoBA,sCAQC;AAGD,sCAcC;AAGD,sCASC;AAzDD;;GAEG;AACH,6CAA+E;AAgB/E,4BAA4B;AAC5B,SAAgB,aAAa,CAAC,YAAsC,EAAE;IACpE,OAAO;QACL,OAAO,EAAE,gBAAO;QAChB,IAAI,EAAE,OAAO;QACb,kBAAkB,EAAE,KAAK;QACzB,oBAAoB,EAAE,OAAO;QAC7B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,SAAgB,aAAa;IAC3B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS,CAAC;IAClE,MAAM,OAAO,GAAG,IAAA,mBAAU,EAAC,WAAW,CAAC,CAAC;IAExC,OAAO;QACL,OAAO;QACP,IAAI,EAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAsB,IAAI,OAAO;QACpE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACxC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC9C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;QAC9C,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAChD,kBAAkB,EAAE,KAAK;QACzB,oBAAoB,EAAE,OAAO;KAC9B,CAAC;AACJ,CAAC;AAED,mCAAmC;AACnC,SAAgB,aAAa,CAAC,YAAsC,EAAE;IACpE,OAAO;QACL,OAAO,EAAE,gBAAO;QAChB,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,wBAAwB;QAChC,kBAAkB,EAAE,QAAQ;QAC5B,oBAAoB,EAAE,SAAS;QAC/B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC"}

package/dist/crypto/base58.d.ts

@@ -0,0 +1,9 @@
+/** Encode raw bytes to Base58 string */
+export declare function b58encode(data: Uint8Array): string;
+/** Decode Base58 string to raw bytes */
+export declare function b58decode(s: string): Uint8Array;
+/** Encode payload with 4-byte checksum (Base58Check) */
+export declare function b58encodeCheck(payload: Uint8Array): string;
+/** Decode Base58Check string, verifying checksum */
+export declare function b58decodeCheck(s: string): Uint8Array;
+//# sourceMappingURL=base58.d.ts.map

package/dist/crypto/base58.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.d.ts","sourceRoot":"","sources":["../../src/crypto/base58.ts"],"names":[],"mappings":"AAkBA,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA8BlD;AAED,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAiC/C;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAM1D;AAED,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAgBpD"}

package/dist/crypto/base58.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.b58encode = b58encode;
+exports.b58decode = b58decode;
+exports.b58encodeCheck = b58encodeCheck;
+exports.b58decodeCheck = b58decodeCheck;
+/**
+ * Base58Check encoding/decoding for legacy DigiByte addresses and WIF keys.
+ */
+const sha256_1 = require("@noble/hashes/sha256");
+const ALPHABET = '123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz';
+const BASE = 58n;
+const ALPHABET_MAP = new Map();
+for (let i = 0; i < ALPHABET.length; i++) {
+    ALPHABET_MAP.set(ALPHABET[i], BigInt(i));
+}
+/** Double-SHA256 hash */
+function doubleSha256(data) {
+    return (0, sha256_1.sha256)((0, sha256_1.sha256)(data));
+}
+/** Encode raw bytes to Base58 string */
+function b58encode(data) {
+    if (data.length === 0)
+        return '';
+    // Count leading zeros
+    let leadingZeros = 0;
+    for (const byte of data) {
+        if (byte !== 0)
+            break;
+        leadingZeros++;
+    }
+    // Convert to bigint
+    let num = 0n;
+    for (const byte of data) {
+        num = num * 256n + BigInt(byte);
+    }
+    // Convert to base58
+    const chars = [];
+    while (num > 0n) {
+        const remainder = num % BASE;
+        num = num / BASE;
+        chars.push(ALPHABET[Number(remainder)]);
+    }
+    // Add leading '1's for leading zero bytes
+    for (let i = 0; i < leadingZeros; i++) {
+        chars.push('1');
+    }
+    return chars.reverse().join('');
+}
+/** Decode Base58 string to raw bytes */
+function b58decode(s) {
+    if (s.length === 0)
+        return new Uint8Array(0);
+    // Count leading '1's
+    let leadingOnes = 0;
+    for (const ch of s) {
+        if (ch !== '1')
+            break;
+        leadingOnes++;
+    }
+    // Convert from base58 to bigint
+    let num = 0n;
+    for (const ch of s) {
+        const val = ALPHABET_MAP.get(ch);
+        if (val === undefined) {
+            throw new Error(`Invalid Base58 character: ${ch}`);
+        }
+        num = num * BASE + val;
+    }
+    // Convert bigint to bytes
+    const bytes = [];
+    while (num > 0n) {
+        bytes.push(Number(num & 0xffn));
+        num = num >> 8n;
+    }
+    bytes.reverse();
+    // Prepend leading zero bytes
+    const result = new Uint8Array(leadingOnes + bytes.length);
+    // Leading zeros are already 0 in Uint8Array
+    result.set(bytes, leadingOnes);
+    return result;
+}
+/** Encode payload with 4-byte checksum (Base58Check) */
+function b58encodeCheck(payload) {
+    const checksum = doubleSha256(payload).slice(0, 4);
+    const data = new Uint8Array(payload.length + 4);
+    data.set(payload);
+    data.set(checksum, payload.length);
+    return b58encode(data);
+}
+/** Decode Base58Check string, verifying checksum */
+function b58decodeCheck(s) {
+    const data = b58decode(s);
+    if (data.length < 5) {
+        throw new Error('Base58Check data too short');
+    }
+    const payload = data.slice(0, data.length - 4);
+    const checksum = data.slice(data.length - 4);
+    const expected = doubleSha256(payload).slice(0, 4);
+    for (let i = 0; i < 4; i++) {
+        if (checksum[i] !== expected[i]) {
+            throw new Error('Invalid Base58Check checksum');
+        }
+    }
+    return payload;
+}
+//# sourceMappingURL=base58.js.map

package/dist/crypto/base58.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base58.js","sourceRoot":"","sources":["../../src/crypto/base58.ts"],"names":[],"mappings":"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"}

package/dist/crypto/bech32.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Bech32 / Bech32m encoding for SegWit addresses (BIP-173 / BIP-350).
+ * DigiByte uses "dgb" (mainnet), "dgbt" (testnet), "dgbrt" (regtest) HRPs.
+ */
+/** Encode a SegWit address */
+export declare function encodeSegwitAddress(hrp: string, witver: number, witprog: Uint8Array): string | null;
+/** Decode a SegWit address. Returns [witnessVersion, witnessProgram] or [null, null]. */
+export declare function decodeSegwitAddress(hrp: string, addr: string): [number, Uint8Array] | [null, null];
+//# sourceMappingURL=bech32.d.ts.map

package/dist/crypto/bech32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bech32.d.ts","sourceRoot":"","sources":["../../src/crypto/bech32.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8EH,8BAA8B;AAC9B,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAcnG;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CA6ClG"}