@originals/sdk 1.2.0 → 1.4.3

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@originals/sdk",
-  "version": "1.2.0",
+  "version": "1.4.3",
   "description": "TypeScript SDK for the Originals Protocol - creating, discovering, and transferring digital assets with cryptographically verifiable provenance",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",

package/.eslintrc.json

@@ -1,33 +0,0 @@
-{
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "module",
-    "project": true
-  },
-  "plugins": ["@typescript-eslint"],
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended",
-    "plugin:@typescript-eslint/recommended-requiring-type-checking"
-  ],
-  "rules": {
-    "@typescript-eslint/no-explicit-any": "warn",
-    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
-    "@typescript-eslint/explicit-function-return-type": "off",
-    "@typescript-eslint/no-unsafe-assignment": "warn",
-    "@typescript-eslint/no-unsafe-member-access": "warn",
-    "@typescript-eslint/no-unsafe-call": "warn",
-    "@typescript-eslint/no-unsafe-return": "warn",
-    "@typescript-eslint/restrict-template-expressions": "warn",
-    "no-console": "off",
-    "no-empty": ["error", { "allowEmptyCatch": false }],
-    "prefer-const": "error",
-    "no-var": "error"
-  },
-  "env": {
-    "node": true,
-    "es6": true
-  },
-  "ignorePatterns": ["dist/", "node_modules/", "legacy/", "apps/", "*.js", "tests/"]
-}

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc && tsc-alias

package/dist/adapters/FeeOracleMock.d.ts

@@ -1,6 +0,0 @@
-import { FeeOracleAdapter } from './types';
-export declare class FeeOracleMock implements FeeOracleAdapter {
-    private feeRate;
-    constructor(feeRate?: number);
-    estimateFeeRate(targetBlocks?: number): Promise<number>;
-}

package/dist/adapters/FeeOracleMock.js

@@ -1,8 +0,0 @@
-export class FeeOracleMock {
-    constructor(feeRate = 7) {
-        this.feeRate = feeRate;
-    }
-    async estimateFeeRate(targetBlocks = 1) {
-        return Math.max(1, this.feeRate - (targetBlocks - 1));
-    }
-}

package/dist/adapters/index.d.ts

@@ -1,4 +0,0 @@
-export * from './types';
-export * from './FeeOracleMock';
-export * from './providers/OrdMockProvider';
-export * from './providers/OrdHttpProvider';

package/dist/adapters/index.js

@@ -1,4 +0,0 @@
-export * from './types';
-export * from './FeeOracleMock';
-export * from './providers/OrdMockProvider';
-export * from './providers/OrdHttpProvider';

package/dist/adapters/providers/OrdHttpProvider.d.ts

@@ -1,56 +0,0 @@
-import type { OrdinalsProvider } from '../types';
-interface HttpProviderOptions {
-    baseUrl: string;
-}
-export declare class OrdHttpProvider implements OrdinalsProvider {
-    private readonly baseUrl;
-    constructor(options: HttpProviderOptions);
-    getInscriptionById(id: string): Promise<{
-        inscriptionId: any;
-        content: any;
-        contentType: any;
-        txid: any;
-        vout: any;
-        satoshi: string;
-        blockHeight: any;
-    } | null>;
-    getInscriptionsBySatoshi(satoshi: string): Promise<{
-        inscriptionId: string;
-    }[]>;
-    broadcastTransaction(_txHexOrObj: unknown): Promise<string>;
-    getTransactionStatus(_txid: string): Promise<{
-        confirmed: boolean;
-    }>;
-    estimateFee(blocks?: number): Promise<number>;
-    createInscription(params: {
-        data: any;
-        contentType: string;
-        feeRate?: number;
-    }): Promise<{
-        inscriptionId: string;
-        revealTxId: string;
-        txid: string;
-        vout: number;
-        blockHeight: undefined;
-        content: any;
-        contentType: string;
-        feeRate: number | undefined;
-    }>;
-    transferInscription(inscriptionId: string, _toAddress: string, _options?: {
-        feeRate?: number;
-    }): Promise<{
-        txid: string;
-        vin: {
-            txid: string;
-            vout: number;
-        }[];
-        vout: {
-            value: number;
-            scriptPubKey: string;
-        }[];
-        fee: number;
-        confirmations: number;
-    }>;
-}
-export declare function createOrdinalsProviderFromEnv(): Promise<OrdinalsProvider>;
-export {};

package/dist/adapters/providers/OrdHttpProvider.js

@@ -1,110 +0,0 @@
-function buildUrl(baseUrl, path) {
-    const base = baseUrl.replace(/\/$/, '');
-    return `${base}${path.startsWith('/') ? '' : '/'}${path}`;
-}
-async function fetchJson(url) {
-    const res = await globalThis.fetch(url, {
-        headers: {
-            'Accept': 'application/json'
-        }
-    });
-    if (!res.ok)
-        return null;
-    return (await res.json());
-}
-export class OrdHttpProvider {
-    constructor(options) {
-        if (!options?.baseUrl) {
-            throw new Error('OrdHttpProvider requires baseUrl');
-        }
-        this.baseUrl = options.baseUrl;
-    }
-    async getInscriptionById(id) {
-        if (!id)
-            return null;
-        const data = await fetchJson(buildUrl(this.baseUrl, `/inscription/${id}`));
-        if (!data)
-            return null;
-        // Expecting a shape similar to Ordinals indexers; adapt minimally
-        const ownerOutput = data.owner_output;
-        let txid = data.txid || 'unknown';
-        let vout = typeof data.vout === 'number' ? data.vout : 0;
-        if (ownerOutput && ownerOutput.includes(':')) {
-            const [tid, v] = ownerOutput.split(':');
-            txid = tid;
-            vout = Number(v) || 0;
-        }
-        const contentType = data.content_type || 'application/octet-stream';
-        const contentUrl = data.content_url || buildUrl(this.baseUrl, `/content/${id}`);
-        const contentRes = await globalThis.fetch(contentUrl);
-        if (!contentRes.ok)
-            return null;
-        const buf = globalThis.Buffer
-            ? globalThis.Buffer.from(new Uint8Array(await contentRes.arrayBuffer()))
-            : new Uint8Array(await contentRes.arrayBuffer());
-        return {
-            inscriptionId: data.inscription_id || id,
-            content: buf,
-            contentType,
-            txid,
-            vout,
-            satoshi: String(data.sat ?? ''),
-            blockHeight: data.block_height
-        };
-    }
-    async getInscriptionsBySatoshi(satoshi) {
-        if (!satoshi)
-            return [];
-        const data = await fetchJson(buildUrl(this.baseUrl, `/sat/${satoshi}`));
-        const ids = Array.isArray(data?.inscription_ids) ? data.inscription_ids : [];
-        return ids.map((inscriptionId) => ({ inscriptionId }));
-    }
-    async broadcastTransaction(_txHexOrObj) {
-        // For example purposes only, return a placeholder
-        return 'broadcast-txid';
-    }
-    async getTransactionStatus(_txid) {
-        return { confirmed: false };
-    }
-    async estimateFee(blocks = 1) {
-        // Basic fallback: some providers expose fee estimates; for example purposes, return linear estimate
-        return 5 * Math.max(1, blocks);
-    }
-    async createInscription(params) {
-        // Example placeholder: a real implementation would POST to a service
-        // Here we return a deterministic mock-like result to avoid network coupling in code
-        const inscriptionId = `insc-${Math.random().toString(36).slice(2)}`;
-        const txid = `tx-${Math.random().toString(36).slice(2)}`;
-        return {
-            inscriptionId,
-            revealTxId: txid,
-            txid,
-            vout: 0,
-            blockHeight: undefined,
-            content: params.data,
-            contentType: params.contentType,
-            feeRate: params.feeRate
-        };
-    }
-    async transferInscription(inscriptionId, _toAddress, _options) {
-        if (!inscriptionId)
-            throw new Error('inscriptionId required');
-        const txid = `tx-${Math.random().toString(36).slice(2)}`;
-        return {
-            txid,
-            vin: [{ txid: 'prev', vout: 0 }],
-            vout: [{ value: 546, scriptPubKey: 'script' }],
-            fee: 100,
-            confirmations: 0
-        };
-    }
-}
-export async function createOrdinalsProviderFromEnv() {
-    const useLive = String((globalThis.process?.env?.USE_LIVE_ORD_PROVIDER) || '').toLowerCase() === 'true';
-    if (useLive) {
-        const baseUrl = (globalThis.process?.env?.ORD_PROVIDER_BASE_URL) || 'https://ord.example.com/api';
-        return new OrdHttpProvider({ baseUrl });
-    }
-    const mod = await import('./OrdMockProvider');
-    return new mod.OrdMockProvider();
-}

package/dist/adapters/providers/OrdMockProvider.d.ts

@@ -1,70 +0,0 @@
-import { OrdinalsProvider } from '../types';
-export interface OrdMockState {
-    inscriptionsById: Map<string, {
-        inscriptionId: string;
-        content: Buffer;
-        contentType: string;
-        txid: string;
-        vout: number;
-        satoshi?: string;
-        blockHeight?: number;
-    }>;
-    inscriptionsBySatoshi: Map<string, string[]>;
-    feeRate: number;
-}
-export declare class OrdMockProvider implements OrdinalsProvider {
-    private state;
-    constructor(state?: Partial<OrdMockState>);
-    getInscriptionById(id: string): Promise<{
-        inscriptionId: string;
-        content: Buffer;
-        contentType: string;
-        txid: string;
-        vout: number;
-        satoshi?: string;
-        blockHeight?: number;
-    } | null>;
-    getInscriptionsBySatoshi(satoshi: string): Promise<{
-        inscriptionId: string;
-    }[]>;
-    broadcastTransaction(_txHexOrObj: unknown): Promise<string>;
-    getTransactionStatus(txid: string): Promise<{
-        confirmed: boolean;
-        blockHeight: number;
-        confirmations: number;
-    }>;
-    estimateFee(blocks?: number): Promise<number>;
-    createInscription(params: {
-        data: Buffer;
-        contentType: string;
-        feeRate?: number;
-    }): Promise<{
-        inscriptionId: string;
-        revealTxId: string;
-        commitTxId: undefined;
-        satoshi: string;
-        txid: string;
-        vout: number;
-        blockHeight: number;
-        content: Buffer<ArrayBufferLike>;
-        contentType: string;
-        feeRate: number | undefined;
-    }>;
-    transferInscription(inscriptionId: string, _toAddress: string, _options?: {
-        feeRate?: number;
-    }): Promise<{
-        txid: string;
-        vin: {
-            txid: string;
-            vout: number;
-        }[];
-        vout: {
-            value: number;
-            scriptPubKey: string;
-        }[];
-        fee: number;
-        blockHeight: number;
-        confirmations: number;
-        satoshi: string | undefined;
-    }>;
-}

package/dist/adapters/providers/OrdMockProvider.js

@@ -1,75 +0,0 @@
-export class OrdMockProvider {
-    constructor(state) {
-        this.state = {
-            inscriptionsById: new Map(),
-            inscriptionsBySatoshi: new Map(),
-            feeRate: 5,
-            ...state
-        };
-    }
-    async getInscriptionById(id) {
-        const rec = this.state.inscriptionsById.get(id);
-        return rec ? { ...rec } : null;
-    }
-    async getInscriptionsBySatoshi(satoshi) {
-        const list = this.state.inscriptionsBySatoshi.get(satoshi) || [];
-        return list.map((inscriptionId) => ({ inscriptionId }));
-    }
-    async broadcastTransaction(_txHexOrObj) {
-        return 'mock-broadcast-txid';
-    }
-    async getTransactionStatus(txid) {
-        return { confirmed: true, blockHeight: 1, confirmations: 1 };
-    }
-    async estimateFee(blocks = 1) {
-        return Math.max(1, this.state.feeRate - (blocks - 1));
-    }
-    async createInscription(params) {
-        const inscriptionId = `insc-${Math.random().toString(36).slice(2)}`;
-        const txid = `tx-${Math.random().toString(36).slice(2)}`;
-        // Generate a valid numeric satoshi identifier (not sat-123 format)
-        const satoshi = `${Math.floor(Math.random() * 1e12)}`;
-        const vout = 0;
-        const record = {
-            inscriptionId,
-            content: params.data,
-            contentType: params.contentType,
-            txid,
-            vout,
-            satoshi,
-            blockHeight: 1
-        };
-        this.state.inscriptionsById.set(inscriptionId, record);
-        const list = this.state.inscriptionsBySatoshi.get(satoshi) || [];
-        list.push(inscriptionId);
-        this.state.inscriptionsBySatoshi.set(satoshi, list);
-        return {
-            inscriptionId,
-            revealTxId: txid,
-            commitTxId: undefined,
-            satoshi,
-            txid,
-            vout,
-            blockHeight: 1,
-            content: params.data,
-            contentType: params.contentType,
-            feeRate: params.feeRate
-        };
-    }
-    async transferInscription(inscriptionId, _toAddress, _options) {
-        const rec = this.state.inscriptionsById.get(inscriptionId);
-        if (!rec) {
-            return Promise.reject(new Error('inscription not found'));
-        }
-        const txid = `tx-${Math.random().toString(36).slice(2)}`;
-        return {
-            txid,
-            vin: [{ txid: rec.txid, vout: rec.vout }],
-            vout: [{ value: 546, scriptPubKey: 'script' }],
-            fee: 100,
-            blockHeight: 1,
-            confirmations: 0,
-            satoshi: rec.satoshi
-        };
-    }
-}

package/dist/adapters/types.d.ts

@@ -1,71 +0,0 @@
-export interface StoragePutOptions {
-    contentType?: string;
-    cacheControl?: string;
-}
-export interface StorageGetResult {
-    content: Buffer;
-    contentType: string;
-}
-export interface StorageAdapter {
-    put(objectKey: string, data: Buffer | string, options?: StoragePutOptions): Promise<string>;
-    get(objectKey: string): Promise<StorageGetResult | null>;
-    delete?(objectKey: string): Promise<boolean>;
-}
-export interface FeeOracleAdapter {
-    estimateFeeRate(targetBlocks?: number): Promise<number>;
-}
-export interface OrdinalsProvider {
-    getInscriptionById(id: string): Promise<{
-        inscriptionId: string;
-        content: Buffer;
-        contentType: string;
-        txid: string;
-        vout: number;
-        satoshi?: string;
-        blockHeight?: number;
-    } | null>;
-    getInscriptionsBySatoshi(satoshi: string): Promise<Array<{
-        inscriptionId: string;
-    }>>;
-    broadcastTransaction(txHexOrObj: unknown): Promise<string>;
-    getTransactionStatus(txid: string): Promise<{
-        confirmed: boolean;
-        blockHeight?: number;
-        confirmations?: number;
-    }>;
-    estimateFee(blocks?: number): Promise<number>;
-    createInscription(params: {
-        data: Buffer;
-        contentType: string;
-        feeRate?: number;
-    }): Promise<{
-        inscriptionId: string;
-        revealTxId: string;
-        commitTxId?: string;
-        satoshi?: string;
-        txid?: string;
-        vout?: number;
-        blockHeight?: number;
-        content?: Buffer;
-        contentType?: string;
-        feeRate?: number;
-    }>;
-    transferInscription(inscriptionId: string, toAddress: string, options?: {
-        feeRate?: number;
-    }): Promise<{
-        txid: string;
-        vin: Array<{
-            txid: string;
-            vout: number;
-        }>;
-        vout: Array<{
-            value: number;
-            scriptPubKey: string;
-            address?: string;
-        }>;
-        fee: number;
-        blockHeight?: number;
-        confirmations?: number;
-        satoshi?: string;
-    }>;
-}

package/dist/adapters/types.js

@@ -1 +0,0 @@
-export {};

package/dist/bitcoin/BitcoinManager.d.ts

@@ -1,15 +0,0 @@
-import { OriginalsConfig, OrdinalsInscription, BitcoinTransaction } from '../types';
-export declare class BitcoinManager {
-    private config;
-    private readonly feeOracle?;
-    private readonly ord?;
-    constructor(config: OriginalsConfig);
-    private resolveFeeRate;
-    inscribeData(data: any, contentType: string, feeRate?: number): Promise<OrdinalsInscription>;
-    trackInscription(inscriptionId: string): Promise<OrdinalsInscription | null>;
-    transferInscription(inscription: OrdinalsInscription, toAddress: string): Promise<BitcoinTransaction>;
-    preventFrontRunning(satoshi: string): Promise<boolean>;
-    getSatoshiFromInscription(inscriptionId: string): Promise<string | null>;
-    validateBTCODID(didId: string): Promise<boolean>;
-    private extractSatoshiFromBTCODID;
-}