paytaca-cli 0.2.0 → 0.3.1

package/dist/utils/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/utils/x402.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,aAAa,EAEb,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAA;AAEjE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,eAAe,GAAG,IAAI,CA6B1E;AAED,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,eAAe,EAC7B,aAAa,EAAE,SAAS,GAAG,SAAS,GACnC,mBAAmB,GAAG,IAAI,CAQ5B;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,cAAc,CAwBhB;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,aAAa,CASf;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,UAAU,GAAE,OAAc,GACzB,MAAM,CAUR;AAED,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAChD,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,GAAG,GAAG,cAAc,CAiB9D"}

package/dist/utils/x402.js

@@ -0,0 +1,119 @@
+/**
+ * x402 utility functions for BCH payments
+ * Implements x402-bch v2.2 specification
+ * https://github.com/x402-bch/x402-bch/blob/master/specs/x402-bch-specification-v2.2.md
+ */
+import crypto from 'crypto';
+import { BCH_ASSET_ID, BCH_MAINNET_NETWORK, BCH_CHIPNET_NETWORK, } from '../types/x402.js';
+import { secp256k1 } from '@bitauth/libauth';
+export { BCH_MAINNET_NETWORK, BCH_CHIPNET_NETWORK, BCH_ASSET_ID };
+export function isBchNetwork(network) {
+    return network === BCH_MAINNET_NETWORK || network === BCH_CHIPNET_NETWORK;
+}
+export function isChipnetNetwork(network) {
+    return network === BCH_CHIPNET_NETWORK;
+}
+export function parsePaymentRequiredJson(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    if (body.x402Version !== 2)
+        return null;
+    const pr = {
+        x402Version: body.x402Version,
+        error: body.error,
+        resource: body.resource || { url: '' },
+        accepts: [],
+        extensions: body.extensions || {},
+    };
+    if (Array.isArray(body.accepts)) {
+        for (const accept of body.accepts) {
+            if (accept.scheme && accept.network && accept.payTo) {
+                pr.accepts.push({
+                    scheme: accept.scheme,
+                    network: accept.network,
+                    amount: accept.amount,
+                    asset: accept.asset || BCH_ASSET_ID,
+                    payTo: accept.payTo,
+                    maxTimeoutSeconds: accept.maxTimeoutSeconds || 60,
+                    extra: accept.extra || {},
+                });
+            }
+        }
+    }
+    return pr;
+}
+export function selectBchPaymentRequirements(requirements, clientNetwork) {
+    const clientNetworkId = clientNetwork === 'chipnet' ? BCH_CHIPNET_NETWORK : BCH_MAINNET_NETWORK;
+    for (const accept of requirements.accepts) {
+        if (accept.scheme === 'utxo' && accept.network === clientNetworkId) {
+            return accept;
+        }
+    }
+    return null;
+}
+export function buildPaymentPayload(accepted, resourceUrl, payer, txid, vout, amount) {
+    const resource = {
+        url: resourceUrl,
+        description: '',
+        mimeType: 'application/json',
+    };
+    return {
+        x402Version: 2,
+        resource,
+        accepted,
+        payload: {
+            signature: '',
+            authorization: {
+                from: payer,
+                to: accepted.payTo,
+                value: accepted.amount,
+                txid,
+                vout,
+                amount,
+            },
+        },
+        extensions: {},
+    };
+}
+export function buildAuthorization(accepted, resourceUrl, payer, txid, vout, amount) {
+    return {
+        from: payer,
+        to: accepted.payTo,
+        value: accepted.amount,
+        txid,
+        vout,
+        amount,
+    };
+}
+export function signMessageBCH(message, privateKeyHex, compressed = true) {
+    const prefix = '\x18Bitcoin Signed Message:\n';
+    const messageBytes = Buffer.from(message, 'utf8');
+    const prefixBytes = Buffer.from(prefix, 'utf8');
+    const lengthByte = Buffer.from([messageBytes.length]);
+    const prefixedMessage = Buffer.concat([prefixBytes, lengthByte, messageBytes]);
+    const hash = crypto.createHash('sha256').update(crypto.createHash('sha256').update(prefixedMessage).digest()).digest();
+    const privateKey = Buffer.from(privateKeyHex, 'hex');
+    const signature = secp256k1.signMessageHashDER(hash, privateKey);
+    return Buffer.from(signature).toString('base64');
+}
+export async function signAuthorization(authorization, signMessage) {
+    const message = JSON.stringify(authorization);
+    return signMessage(message);
+}
+export function parsePaymentResponse(data) {
+    if (!data)
+        return { isValid: false, invalidReason: 'no_response_data' };
+    if (typeof data.isValid === 'boolean') {
+        return {
+            isValid: data.isValid,
+            payer: data.payer,
+            invalidReason: data.invalidReason,
+            remainingBalanceSat: data.remainingBalanceSat,
+        };
+    }
+    if (data.error) {
+        return { isValid: false, invalidReason: data.error };
+    }
+    return { isValid: false, invalidReason: 'unknown_response_format' };
+}
+//# sourceMappingURL=x402.js.map

package/dist/utils/x402.js.map

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

package/dist/utils/x402.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=x402.test.d.ts.map

package/dist/utils/x402.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.test.d.ts","sourceRoot":"","sources":["../../src/utils/x402.test.ts"],"names":[],"mappings":""}

package/dist/utils/x402.test.js

@@ -0,0 +1,216 @@
+import { describe, it, expect } from 'vitest';
+import { parsePaymentRequiredJson, selectBchPaymentRequirements, buildPaymentPayload, buildAuthorization, parsePaymentResponse, isBchNetwork, isChipnetNetwork, BCH_MAINNET_NETWORK, BCH_CHIPNET_NETWORK, BCH_ASSET_ID, } from './x402.js';
+describe('x402 parsing', () => {
+    describe('parsePaymentRequiredJson', () => {
+        it('should parse valid PaymentRequired JSON', () => {
+            const input = {
+                x402Version: 2,
+                error: 'Payment required',
+                resource: { url: 'https://api.example.com/data' },
+                accepts: [
+                    {
+                        scheme: 'utxo',
+                        network: BCH_MAINNET_NETWORK,
+                        amount: '1000',
+                        asset: BCH_ASSET_ID,
+                        payTo: 'bitcoincash:qp2f5j6q3fj5gjwgk8rkq8xrk8q8q8q8q8q8q8q8q',
+                        maxTimeoutSeconds: 300,
+                        extra: {},
+                    },
+                ],
+                extensions: {},
+            };
+            const result = parsePaymentRequiredJson(input);
+            expect(result).not.toBeNull();
+            expect(result.x402Version).toBe(2);
+            expect(result.error).toBe('Payment required');
+            expect(result.resource.url).toBe('https://api.example.com/data');
+            expect(result.accepts).toHaveLength(1);
+            expect(result.accepts[0].scheme).toBe('utxo');
+            expect(result.accepts[0].amount).toBe('1000');
+        });
+        it('should return null for null input', () => {
+            expect(parsePaymentRequiredJson(null)).toBeNull();
+        });
+        it('should return null for non-object input', () => {
+            expect(parsePaymentRequiredJson('string')).toBeNull();
+            expect(parsePaymentRequiredJson(123)).toBeNull();
+        });
+        it('should return null for wrong x402Version', () => {
+            const input = { x402Version: 1, accepts: [] };
+            expect(parsePaymentRequiredJson(input)).toBeNull();
+        });
+        it('should use default values for missing optional fields', () => {
+            const input = {
+                x402Version: 2,
+                resource: {},
+                accepts: [
+                    {
+                        scheme: 'utxo',
+                        network: BCH_MAINNET_NETWORK,
+                        payTo: 'bitcoincash:qp2f5j6q3fj5gjwgk8rkq8xrk8q8q8q8q8q8q8q8',
+                    },
+                ],
+            };
+            const result = parsePaymentRequiredJson(input);
+            expect(result).not.toBeNull();
+            expect(result.accepts[0].asset).toBe(BCH_ASSET_ID);
+            expect(result.accepts[0].maxTimeoutSeconds).toBe(60);
+        });
+        it('should filter out invalid accepts entries', () => {
+            const input = {
+                x402Version: 2,
+                resource: { url: 'https://api.example.com' },
+                accepts: [
+                    { scheme: 'utxo', network: BCH_MAINNET_NETWORK, payTo: 'valid1' },
+                    { scheme: 'invalid' },
+                    { network: BCH_MAINNET_NETWORK, payTo: 'missing-scheme' },
+                    { scheme: 'utxo', payTo: 'missing-network' },
+                    { scheme: 'utxo', network: BCH_MAINNET_NETWORK },
+                ],
+            };
+            const result = parsePaymentRequiredJson(input);
+            expect(result.accepts).toHaveLength(1);
+            expect(result.accepts[0].payTo).toBe('valid1');
+        });
+    });
+    describe('selectBchPaymentRequirements', () => {
+        const paymentRequired = {
+            x402Version: 2,
+            resource: { url: 'https://api.example.com' },
+            accepts: [
+                {
+                    scheme: 'utxo',
+                    network: BCH_MAINNET_NETWORK,
+                    amount: '1000',
+                    asset: BCH_ASSET_ID,
+                    payTo: 'bitcoincash:mainnet-address',
+                    maxTimeoutSeconds: 300,
+                    extra: {},
+                },
+                {
+                    scheme: 'utxo',
+                    network: BCH_CHIPNET_NETWORK,
+                    amount: '1000',
+                    asset: BCH_ASSET_ID,
+                    payTo: 'bitcoincash:chipnet-address',
+                    maxTimeoutSeconds: 300,
+                    extra: {},
+                },
+            ],
+            extensions: {},
+        };
+        it('should select mainnet requirements for mainnet client', () => {
+            const result = selectBchPaymentRequirements(paymentRequired, 'mainnet');
+            expect(result).not.toBeNull();
+            expect(result.network).toBe(BCH_MAINNET_NETWORK);
+            expect(result.payTo).toBe('bitcoincash:mainnet-address');
+        });
+        it('should select chipnet requirements for chipnet client', () => {
+            const result = selectBchPaymentRequirements(paymentRequired, 'chipnet');
+            expect(result).not.toBeNull();
+            expect(result.network).toBe(BCH_CHIPNET_NETWORK);
+            expect(result.payTo).toBe('bitcoincash:chipnet-address');
+        });
+        it('should return null when no matching network', () => {
+            const emptyAccepts = { ...paymentRequired, accepts: [paymentRequired.accepts[0]] };
+            const result = selectBchPaymentRequirements(emptyAccepts, 'chipnet');
+            expect(result).toBeNull();
+        });
+    });
+});
+describe('x402 building', () => {
+    describe('buildPaymentPayload', () => {
+        it('should build a valid PaymentPayload', () => {
+            const accepted = {
+                scheme: 'utxo',
+                network: BCH_MAINNET_NETWORK,
+                amount: '1000',
+                asset: BCH_ASSET_ID,
+                payTo: 'bitcoincash:qp2f5j6q3fj5gjwgk8rkq8xrk8q8q8q8q8q8q8q8',
+                maxTimeoutSeconds: 300,
+                extra: {},
+            };
+            const result = buildPaymentPayload(accepted, 'https://api.example.com/data', 'bitcoincash:payer-address', 'abc123txid', 0, '1000');
+            expect(result.x402Version).toBe(2);
+            expect(result.resource.url).toBe('https://api.example.com/data');
+            expect(result.accepted).toBe(accepted);
+            expect(result.payload.authorization.from).toBe('bitcoincash:payer-address');
+            expect(result.payload.authorization.to).toBe(accepted.payTo);
+            expect(result.payload.authorization.txid).toBe('abc123txid');
+            expect(result.payload.signature).toBe('');
+        });
+    });
+    describe('buildAuthorization', () => {
+        it('should build a valid Authorization', () => {
+            const accepted = {
+                scheme: 'utxo',
+                network: BCH_MAINNET_NETWORK,
+                amount: '1000',
+                asset: BCH_ASSET_ID,
+                payTo: 'bitcoincash:qp2f5j6q3fj5gjwgk8rkq8xrk8q8q8q8q8q8q8q8',
+                maxTimeoutSeconds: 300,
+                extra: {},
+            };
+            const result = buildAuthorization(accepted, 'https://api.example.com/data', 'bitcoincash:payer-address', 'abc123txid', 0, '1000');
+            expect(result.from).toBe('bitcoincash:payer-address');
+            expect(result.to).toBe(accepted.payTo);
+            expect(result.txid).toBe('abc123txid');
+            expect(result.vout).toBe(0);
+            expect(result.amount).toBe('1000');
+        });
+    });
+});
+describe('parsePaymentResponse', () => {
+    it('should parse valid isValid response', () => {
+        const data = {
+            isValid: true,
+            payer: 'bitcoincash:abc123',
+            remainingBalanceSat: '1000000',
+        };
+        const result = parsePaymentResponse(data);
+        expect(result.isValid).toBe(true);
+        expect(result.payer).toBe('bitcoincash:abc123');
+        expect(result.remainingBalanceSat).toBe('1000000');
+    });
+    it('should parse error response', () => {
+        const data = { error: 'Invalid signature' };
+        const result = parsePaymentResponse(data);
+        expect(result.isValid).toBe(false);
+        expect(result.invalidReason).toBe('Invalid signature');
+    });
+    it('should return no_response_data for null input', () => {
+        const result = parsePaymentResponse(null);
+        expect(result.isValid).toBe(false);
+        expect(result.invalidReason).toBe('no_response_data');
+    });
+    it('should return unknown_response_format for unrecognized data', () => {
+        const data = { some: 'unknown', format: true };
+        const result = parsePaymentResponse(data);
+        expect(result.isValid).toBe(false);
+        expect(result.invalidReason).toBe('unknown_response_format');
+    });
+});
+describe('network helpers', () => {
+    describe('isBchNetwork', () => {
+        it('should return true for mainnet', () => {
+            expect(isBchNetwork(BCH_MAINNET_NETWORK)).toBe(true);
+        });
+        it('should return true for chipnet', () => {
+            expect(isBchNetwork(BCH_CHIPNET_NETWORK)).toBe(true);
+        });
+        it('should return false for other networks', () => {
+            expect(isBchNetwork('bitcoin')).toBe(false);
+            expect(isBchNetwork('litecoin')).toBe(false);
+        });
+    });
+    describe('isChipnetNetwork', () => {
+        it('should return true for chipnet', () => {
+            expect(isChipnetNetwork(BCH_CHIPNET_NETWORK)).toBe(true);
+        });
+        it('should return false for mainnet', () => {
+            expect(isChipnetNetwork(BCH_MAINNET_NETWORK)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=x402.test.js.map

package/dist/utils/x402.test.js.map

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

package/dist/wallet/x402.d.ts

@@ -0,0 +1,29 @@
+/**
+ * x402 payment handler for BCH
+ * Implements x402-bch v2.2 specification
+ * https://github.com/x402-bch/x402-bch/blob/master/specs/x402-bch-specification-v2.2.md
+ */
+import { LibauthHDWallet } from './keys.js';
+import { PaymentRequirements, PaymentPayload } from '../types/x402.js';
+export interface X402Signer {
+    address: string;
+    signMessage: (message: string) => Promise<string>;
+}
+export interface X402PayerConfig {
+    hdWallet: LibauthHDWallet;
+    addressIndex?: number;
+}
+export declare class X402Payer {
+    private signer;
+    private isChipnet;
+    constructor(config: X402PayerConfig);
+    private createSigner;
+    getPayerAddress(): string;
+    createPaymentPayload(requirements: PaymentRequirements, resourceUrl: string, txid: string, vout: number | null, amount: string | null): Promise<PaymentPayload>;
+    makePaymentRequest(requirements: PaymentRequirements, resourceUrl: string, txid: string, vout: number | null, amount: string | null): Promise<{
+        paymentPayload: PaymentPayload;
+        paymentUrl: string;
+    }>;
+}
+export declare function createX402Payer(hdWallet: LibauthHDWallet, addressIndex?: number): X402Payer;
+//# sourceMappingURL=x402.d.ts.map

package/dist/wallet/x402.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/wallet/x402.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAS3C,OAAO,EAEL,mBAAmB,EACnB,cAAc,EAGf,MAAM,kBAAkB,CAAA;AAEzB,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,eAAe;IAKnC,OAAO,CAAC,YAAY;IAYpB,eAAe,IAAI,MAAM;IAInB,oBAAoB,CACxB,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,cAAc,CAAC;IAgBpB,kBAAkB,CACtB,YAAY,EAAE,mBAAmB,EACjC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC;QAAE,cAAc,EAAE,cAAc,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAQnE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAE3F"}

package/dist/wallet/x402.js

@@ -0,0 +1,45 @@
+/**
+ * x402 payment handler for BCH
+ * Implements x402-bch v2.2 specification
+ * https://github.com/x402-bch/x402-bch/blob/master/specs/x402-bch-specification-v2.2.md
+ */
+import { buildPaymentPayload, signAuthorization, signMessageBCH, } from '../utils/x402.js';
+export class X402Payer {
+    signer;
+    isChipnet;
+    constructor(config) {
+        this.isChipnet = config.hdWallet.isChipnet;
+        this.signer = this.createSigner(config.hdWallet, config.addressIndex || 0);
+    }
+    createSigner(hdWallet, index) {
+        const addressSet = hdWallet.getAddressSetAt(index);
+        return {
+            address: addressSet.receiving,
+            signMessage: async (message) => {
+                const node = hdWallet.getNodeAt(`0/${index}`);
+                const privKeyHex = Buffer.from(node.privateKey).toString('hex');
+                return signMessageBCH(message, privKeyHex, true);
+            },
+        };
+    }
+    getPayerAddress() {
+        return this.signer.address;
+    }
+    async createPaymentPayload(requirements, resourceUrl, txid, vout, amount) {
+        const payload = buildPaymentPayload(requirements, resourceUrl, this.signer.address, txid, vout, amount);
+        const signature = await signAuthorization(payload.payload.authorization, this.signer.signMessage.bind(this.signer));
+        payload.payload.signature = signature;
+        return payload;
+    }
+    async makePaymentRequest(requirements, resourceUrl, txid, vout, amount) {
+        const paymentPayload = await this.createPaymentPayload(requirements, resourceUrl, txid, vout, amount);
+        return {
+            paymentPayload,
+            paymentUrl: requirements.payTo,
+        };
+    }
+}
+export function createX402Payer(hdWallet, addressIndex) {
+    return new X402Payer({ hdWallet, addressIndex });
+}
+//# sourceMappingURL=x402.js.map

package/dist/wallet/x402.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../src/wallet/x402.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAGL,mBAAmB,EAEnB,iBAAiB,EACjB,cAAc,GACf,MAAM,kBAAkB,CAAA;AAmBzB,MAAM,OAAO,SAAS;IACZ,MAAM,CAAY;IAClB,SAAS,CAAS;IAE1B,YAAY,MAAuB;QACjC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAA;QAC1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,CAAC,CAAA;IAC5E,CAAC;IAEO,YAAY,CAAC,QAAyB,EAAE,KAAa;QAC3D,MAAM,UAAU,GAAG,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;QAClD,OAAO;YACL,OAAO,EAAE,UAAU,CAAC,SAAS;YAC7B,WAAW,EAAE,KAAK,EAAE,OAAe,EAAE,EAAE;gBACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC,CAAA;gBAC7C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;gBAC/D,OAAO,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;YAClD,CAAC;SACF,CAAA;IACH,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,YAAiC,EACjC,WAAmB,EACnB,IAAY,EACZ,IAAmB,EACnB,MAAqB;QAErB,MAAM,OAAO,GAAG,mBAAmB,CACjC,YAAY,EACZ,WAAW,EACX,IAAI,CAAC,MAAM,CAAC,OAAO,EACnB,IAAI,EACJ,IAAI,EACJ,MAAM,CACP,CAAA;QAED,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QACnH,OAAO,CAAC,OAAO,CAAC,SAAS,GAAG,SAAS,CAAA;QAErC,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,YAAiC,EACjC,WAAmB,EACnB,IAAY,EACZ,IAAmB,EACnB,MAAqB;QAErB,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAErG,OAAO;YACL,cAAc;YACd,UAAU,EAAE,YAAY,CAAC,KAAK;SAC/B,CAAA;IACH,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,QAAyB,EAAE,YAAqB;IAC9E,OAAO,IAAI,SAAS,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAA;AAClD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paytaca-cli",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Command-line interface for the Paytaca Bitcoin Cash wallet",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,7 @@
   "files": [
     "bin/",
     "dist/",
+    "skills/",
     "LICENSE",
     "README.md"
   ],
@@ -19,6 +20,8 @@
     "dev": "tsc --watch",
     "start": "node bin/paytaca.js",
     "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run clean && npm run build"
   },
   "keywords": [
@@ -49,7 +52,9 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/qrcode-terminal": "^0.12.2",
-    "typescript": "^5.9.3"
+    "@vitest/ui": "^4.1.2",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.2"
   },
   "engines": {
     "node": ">=20.0.0"

package/skills/paytaca/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: paytaca-x402
+description: Handles x402 HTTP payment requests using Paytaca BCH wallet. Use when encountering HTTP 402 responses or when calling APIs that may require payment via the x402 protocol.
+---
+
+# Paytaca x402 Payment Handler
+
+This skill teaches the agent how to handle x402-based HTTP payments using the Paytaca CLI wallet.
+
+## Overview
+
+Some APIs (like nanogpt, etc.) use the x402 protocol for HTTP payments. When you call these APIs:
+- Server returns **HTTP 402 PAYMENT REQUIRED**
+- You must pay with BCH to access the resource
+- After payment, the server returns the actual response
+
+## Commands
+
+### Check if a URL requires payment (recommended first step)
+
+```bash
+paytaca check <url> --json
+# Returns: acceptsX402, acceptsBch, estimatedCostSats, etc.
+```
+
+Example output:
+```json
+{
+  "url": "https://api.nanogpt.com/v1/complete",
+  "acceptsX402": true,
+  "acceptsBch": true,
+  "paymentRequired": true,
+  "estimatedCostSats": "100",
+  "costInBch": "0.00000100"
+}
+```
+
+### Preview payment without executing (dry-run)
+
+```bash
+paytaca pay <url> --dry-run --json
+# Shows what would happen without actually paying
+```
+
+### Make a paid request
+
+```bash
+# Basic (will prompt for confirmation)
+paytaca pay <url>
+
+# With JSON output (preferred for AI agents)
+paytaca pay <url> --json
+
+# Skip confirmation prompt (only use after user has already approved via paytaca check)
+paytaca pay <url> --confirmed
+
+# POST request
+paytaca pay <url> --method POST --body '{"prompt":"hello"}'
+
+# Custom headers
+paytaca pay <url> -H "Authorization: Bearer token123"
+```
+
+### Check wallet balance
+
+```bash
+paytaca balance
+```
+
+## Decision Flow
+
+When preparing to call an unfamiliar API that might require payment:
+
+1. **First check**: `paytaca check <url> --json`
+   - If `paymentRequired: false` → proceed normally
+   - If `paymentRequired: true` and `acceptsBch: true` → inform user of cost and **seek explicit approval** before paying
+   - If `paymentRequired: true` but `acceptsBch: false` → inform user
+
+2. **When encountering HTTP 402**:
+   - Parse the `PAYMENT-REQUIRED` headers
+   - **Seek explicit user approval** before spending any BCH
+   - Once approved, use `paytaca pay <url> --json` to handle payment
+   - The command handles: parse headers → build BCH tx → broadcast → retry with signature
+
+3. **For known paid APIs**:
+   - **Always seek user approval first**, then use `paytaca pay <url>` - it handles 402 automatically
+
+## ⚠️ User Approval Required Before Any Payment
+
+**CRITICAL**: The agent MUST NOT execute `paytaca pay` without explicit user approval. Since `paytaca pay` spends real BCH from the user's wallet, always:
+
+1. Run `paytaca check <url> --json` first to determine the cost
+2. Inform the user of the cost (e.g., "This API costs ~1000 sats")
+3. Wait for explicit user confirmation (e.g., "yes", "go ahead", "pay")
+4. Only then execute the payment using `paytaca pay <url> --confirmed --json`
+
+The `--confirmed` flag skips the interactive confirmation prompt since the user has already approved the transaction. Do NOT use `--confirmed` without first obtaining explicit user approval.
+
+Do NOT assume the user wants to pay - even if the cost seems small.
+
+## AI Agent Workflow
+
+```
+Task: Call nanogpt API
+Agent: paytaca check https://api.nanogpt.com/v1/complete --json
+  → {"acceptsBch": true, "estimatedCostSats": "100"}
+
+Agent: Informs user "This API costs 100 sats (0.00000100 BCH). Approve to proceed?"
+User: "yes"
+
+Agent: paytaca pay https://api.nanogpt.com/v1/complete --method POST --body '{"prompt":"hello"}' --confirmed --json
+  → Handles 402 → pays 100 sats → returns response with txid
+```
+
+## Key Options
+
+| Option | Description |
+|--------|-------------|
+| `--json` | Machine-readable output (recommended for AI) |
+| `--dry-run` | Preview payment without executing |
+| `--confirmed` | Skip confirmation prompt (prior approval obtained) |
+| `--chipnet` | Use chipnet (testnet) instead of mainnet |
+| `--max-amount` | Override max payment amount in sats |
+
+## Notes
+
+- Payment is per-request (no batching)
+- Each request = separate BCH transaction
+- Only BCH payments are supported (no stablecoins)
+- Uses local wallet from OS keychain (credentials never leave the machine)