@atxp/common 0.8.0 → 0.8.2

package/dist/atxpAccount.d.ts

@@ -0,0 +1,18 @@
+import type { Account, PaymentMaker } from './types.js';
+import type { FetchLike, AccountId, Source } from './types.js';
+export declare class ATXPAccount implements Account {
+    accountId: AccountId;
+    paymentMakers: PaymentMaker[];
+    origin: string;
+    token: string;
+    fetchFn: FetchLike;
+    private unqualifiedAccountId;
+    constructor(connectionString: string, opts?: {
+        fetchFn?: FetchLike;
+    });
+    /**
+     * Get sources for this account by calling the accounts service
+     */
+    getSources(): Promise<Source[]>;
+}
+//# sourceMappingURL=atxpAccount.d.ts.map

package/dist/atxpAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atxpAccount.d.ts","sourceRoot":"","sources":["../src/atxpAccount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAY,SAAS,EAAyC,MAAM,EAAE,MAAM,YAAY,CAAC;AA2IhH,qBAAa,WAAY,YAAW,OAAO;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,gBAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,SAAS,CAAC;KAAE;IAkBrE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAuBtC"}

package/dist/atxpAccount.js

@@ -0,0 +1,156 @@
+function toBasicAuth(token) {
+    // Basic auth is base64("username:password"), password is blank
+    const b64 = Buffer.from(`${token}:`).toString('base64');
+    return `Basic ${b64}`;
+}
+function parseConnectionString(connectionString) {
+    const url = new URL(connectionString);
+    const origin = url.origin;
+    const token = url.searchParams.get('connection_token') || '';
+    const accountId = url.searchParams.get('account_id');
+    if (!token) {
+        throw new Error('ATXPAccount: connection string missing connection token');
+    }
+    if (!accountId) {
+        throw new Error('ATXPAccount: connection string missing account id');
+    }
+    return { origin, token, accountId };
+}
+class ATXPHttpPaymentMaker {
+    constructor(origin, token, fetchFn = fetch) {
+        this.origin = origin;
+        this.token = token;
+        this.fetchFn = fetchFn;
+    }
+    async getSourceAddress(params) {
+        // Call the /address_for_payment endpoint to get the source address for this account
+        const response = await this.fetchFn(`${this.origin}/address_for_payment`, {
+            method: 'POST',
+            headers: {
+                'Authorization': toBasicAuth(this.token),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                amount: params.amount.toString(),
+                currency: params.currency,
+                receiver: params.receiver,
+                memo: params.memo,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`ATXPAccount: /address_for_payment failed: ${response.status} ${response.statusText} ${text}`);
+        }
+        const json = await response.json();
+        if (!json?.sourceAddress) {
+            throw new Error('ATXPAccount: /address_for_payment did not return sourceAddress');
+        }
+        return json.sourceAddress;
+    }
+    async makePayment(destinations, memo, paymentRequestId) {
+        // Make a payment via the /pay endpoint with multiple destinations
+        const response = await this.fetchFn(`${this.origin}/pay`, {
+            method: 'POST',
+            headers: {
+                'Authorization': toBasicAuth(this.token),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                destinations: destinations.map(d => ({
+                    chain: d.chain,
+                    address: d.address,
+                    amount: d.amount.toString(),
+                    currency: d.currency
+                })),
+                memo,
+                ...(paymentRequestId && { paymentRequestId })
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`ATXPAccount: /pay failed: ${response.status} ${response.statusText} ${text}`);
+        }
+        const json = await response.json();
+        const transactionId = json.transactionId;
+        if (!transactionId) {
+            throw new Error('ATXPAccount: /pay did not return transactionId or txHash');
+        }
+        if (!json?.chain) {
+            throw new Error('ATXPAccount: /pay did not return chain');
+        }
+        if (!json?.currency) {
+            throw new Error('ATXPAccount: /pay did not return currency');
+        }
+        return {
+            transactionId,
+            ...(json.transactionSubId ? { transactionSubId: json.transactionSubId } : {}),
+            chain: json.chain,
+            currency: json.currency
+        };
+    }
+    async generateJWT(params) {
+        const response = await this.fetchFn(`${this.origin}/sign`, {
+            method: 'POST',
+            headers: {
+                'Authorization': toBasicAuth(this.token),
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                paymentRequestId: params.paymentRequestId,
+                codeChallenge: params.codeChallenge,
+                ...(params.accountId ? { accountId: params.accountId } : {}),
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`ATXPAccount: /sign failed: ${response.status} ${response.statusText} ${text}`);
+        }
+        const json = await response.json();
+        if (!json?.jwt) {
+            throw new Error('ATXPAccount: /sign did not return jwt');
+        }
+        return json.jwt;
+    }
+}
+class ATXPAccount {
+    constructor(connectionString, opts) {
+        const { origin, token, accountId } = parseConnectionString(connectionString);
+        const fetchFn = opts?.fetchFn ?? fetch;
+        // Store for use in X402 payment creation
+        this.origin = origin;
+        this.token = token;
+        this.fetchFn = fetchFn;
+        // Format accountId as network:address
+        // Connection string provides just the atxp_acct_xxx part (no prefix for UI)
+        this.unqualifiedAccountId = accountId;
+        this.accountId = `atxp:${accountId}`;
+        this.paymentMakers = [
+            new ATXPHttpPaymentMaker(origin, token, fetchFn)
+        ];
+    }
+    /**
+     * Get sources for this account by calling the accounts service
+     */
+    async getSources() {
+        // Use the unqualified account ID (without atxp: prefix) for the API call
+        const response = await this.fetchFn(`${this.origin}/account/${this.unqualifiedAccountId}/sources`, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+            }
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`ATXPAccount: /account/${this.unqualifiedAccountId}/sources failed: ${response.status} ${response.statusText} ${text}`);
+        }
+        const json = await response.json();
+        // The accounts service returns the sources array directly, not wrapped in an object
+        if (!Array.isArray(json)) {
+            throw new Error(`ATXPAccount: /account/${this.unqualifiedAccountId}/sources did not return sources array`);
+        }
+        return json;
+    }
+}
+
+export { ATXPAccount };
+//# sourceMappingURL=atxpAccount.js.map

package/dist/atxpAccount.js.map

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

package/dist/es256kJwtHelper.d.ts

@@ -0,0 +1,41 @@
+import type { AccountId } from './types.js';
+export interface ES256KJWTPayload {
+    sub: string;
+    iss: string;
+    aud: string;
+    iat: number;
+    exp: number;
+    code_challenge?: string;
+    payment_request_id?: string;
+    account_id?: AccountId;
+    source_address?: string;
+}
+/**
+ * Build the unsigned JWT message that needs to be signed
+ *
+ * @param params Parameters for building the JWT message
+ * @returns Object containing the message to sign and the encoded header/payload
+ */
+export declare function buildES256KJWTMessage(params: {
+    walletAddress: string;
+    codeChallenge: string;
+    paymentRequestId: string;
+    accountId?: AccountId | null;
+}): {
+    message: string;
+    headerB64: string;
+    payloadB64: string;
+};
+/**
+ * Complete an ES256K JWT with a signature
+ *
+ * @param params Parameters for completing the JWT
+ * @param params.message The message that was signed (header.payload)
+ * @param params.signature The ECDSA signature from personal_sign (0x... 130 hex chars / 65 bytes)
+ * @returns Complete ES256K JWT string
+ */
+export declare function completeES256KJWT(params: {
+    message: string;
+    signature: string;
+}): string;
+//# sourceMappingURL=es256kJwtHelper.d.ts.map

package/dist/es256kJwtHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"es256kJwtHelper.d.ts","sourceRoot":"","sources":["../src/es256kJwtHelper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAkB5C,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAC9B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAsC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAsCT"}

package/dist/es256kJwtHelper.js

@@ -0,0 +1,135 @@
+/**
+ * ES256K JWT Helper for Browser Wallets
+ *
+ * This module provides functions to create ES256K JWTs for Ethereum EOA (Externally Owned Account)
+ * wallets in browser environments. Unlike EIP-1271 which is designed for smart contract wallets,
+ * ES256K works with standard ECDSA signatures from wallets like MetaMask.
+ *
+ * The auth server verifies these JWTs using cryptographic signature recovery, which:
+ * - Works with standard 65-byte ECDSA signatures (r, s, v)
+ * - Doesn't require smart contract calls
+ * - Is faster and more efficient for EOA wallets
+ */
+const ISSUER = 'atxp.ai';
+const AUDIENCE = 'https://auth.atxp.ai';
+/**
+ * Build the unsigned JWT message that needs to be signed
+ *
+ * @param params Parameters for building the JWT message
+ * @returns Object containing the message to sign and the encoded header/payload
+ */
+function buildES256KJWTMessage(params) {
+    const now = Math.floor(Date.now() / 1000);
+    // Build the payload
+    const payload = {
+        sub: params.accountId || params.walletAddress,
+        iss: ISSUER,
+        aud: AUDIENCE,
+        iat: now,
+        exp: now + 120, // 2 minutes expiration
+    };
+    // Add optional fields only if they have values
+    if (params.codeChallenge) {
+        payload.code_challenge = params.codeChallenge;
+    }
+    if (params.paymentRequestId) {
+        payload.payment_request_id = params.paymentRequestId;
+    }
+    if (params.accountId) {
+        payload.account_id = params.accountId;
+        payload.source_address = params.walletAddress;
+    }
+    // Create JWT header
+    const header = {
+        alg: 'ES256K',
+        typ: 'JWT'
+    };
+    // Encode header and payload as base64url
+    const headerB64 = base64urlEncode(JSON.stringify(header));
+    const payloadB64 = base64urlEncode(JSON.stringify(payload));
+    // The message to sign is header.payload
+    const message = `${headerB64}.${payloadB64}`;
+    return { message, headerB64, payloadB64 };
+}
+/**
+ * Complete an ES256K JWT with a signature
+ *
+ * @param params Parameters for completing the JWT
+ * @param params.message The message that was signed (header.payload)
+ * @param params.signature The ECDSA signature from personal_sign (0x... 130 hex chars / 65 bytes)
+ * @returns Complete ES256K JWT string
+ */
+function completeES256KJWT(params) {
+    // Convert the signature from hex to base64url
+    // The signature from personal_sign is in format: 0x + r (32 bytes) + s (32 bytes) + v (1 byte)
+    // For JWT ES256K, we need just r + s in base64url format (v is implicit)
+    let signature = params.signature;
+    if (signature.startsWith('0x')) {
+        signature = signature.slice(2);
+    }
+    // Validate signature length (should be 130 hex chars = 65 bytes)
+    if (signature.length !== 130) {
+        throw new Error(`Invalid signature length: expected 130 hex chars, got ${signature.length}`);
+    }
+    // Extract r and s (first 64 bytes, ignore v which is the last byte)
+    const rHex = signature.slice(0, 64);
+    const sHex = signature.slice(64, 128);
+    const vHex = signature.slice(128, 130);
+    // Convert r and s to bytes
+    const rBytes = hexToBytes(rHex);
+    const sBytes = hexToBytes(sHex);
+    const vByte = parseInt(vHex, 16);
+    // Normalize v to 0 or 1 (MetaMask returns 27/28, but we need 0/1)
+    const vNormalized = vByte >= 27 ? vByte - 27 : vByte;
+    // Combine r + s + v as a single byte array
+    const signatureBytes = new Uint8Array(65);
+    signatureBytes.set(rBytes, 0);
+    signatureBytes.set(sBytes, 32);
+    signatureBytes[64] = vNormalized;
+    // Encode as base64url
+    const signatureB64 = base64urlEncodeBytes(signatureBytes);
+    // Construct the JWT
+    return `${params.message}.${signatureB64}`;
+}
+/**
+ * Base64URL encode a string
+ */
+function base64urlEncode(str) {
+    // Convert string to bytes
+    const bytes = new TextEncoder().encode(str);
+    return base64urlEncodeBytes(bytes);
+}
+/**
+ * Base64URL encode a byte array
+ */
+function base64urlEncodeBytes(bytes) {
+    // Convert to base64
+    let base64 = '';
+    if (typeof Buffer !== 'undefined') {
+        // Node.js environment
+        base64 = Buffer.from(bytes).toString('base64');
+    }
+    else {
+        // Browser environment
+        const binary = Array.from(bytes).map(b => String.fromCharCode(b)).join('');
+        base64 = btoa(binary);
+    }
+    // Convert base64 to base64url (replace +/= with -_)
+    return base64
+        .replace(/\+/g, '-')
+        .replace(/\//g, '_')
+        .replace(/=/g, '');
+}
+/**
+ * Convert hex string to bytes
+ */
+function hexToBytes(hex) {
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < hex.length; i += 2) {
+        bytes[i / 2] = parseInt(hex.slice(i, i + 2), 16);
+    }
+    return bytes;
+}
+
+export { buildES256KJWTMessage, completeES256KJWT };
+//# sourceMappingURL=es256kJwtHelper.js.map

package/dist/es256kJwtHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"es256kJwtHelper.js","sources":["../src/es256kJwtHelper.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;;;;AAWG;AAEH,MAAM,MAAM,GAAG,SAAS;AACxB,MAAM,QAAQ,GAAG,sBAAsB;AAcvC;;;;;AAKG;AACG,SAAU,qBAAqB,CAAC,MAKrC,EAAA;AACC,IAAA,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;;AAGzC,IAAA,MAAM,OAAO,GAAqB;AAChC,QAAA,GAAG,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,aAAa;AAC7C,QAAA,GAAG,EAAE,MAAM;AACX,QAAA,GAAG,EAAE,QAAQ;AACb,QAAA,GAAG,EAAE,GAAG;AACR,QAAA,GAAG,EAAE,GAAG,GAAG,GAAG;KACf;;AAGD,IAAA,IAAI,MAAM,CAAC,aAAa,EAAE;AACxB,QAAA,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa;IAC/C;AACA,IAAA,IAAI,MAAM,CAAC,gBAAgB,EAAE;AAC3B,QAAA,OAAO,CAAC,kBAAkB,GAAG,MAAM,CAAC,gBAAgB;IACtD;AACA,IAAA,IAAI,MAAM,CAAC,SAAS,EAAE;AACpB,QAAA,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS;AACrC,QAAA,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa;IAC/C;;AAGA,IAAA,MAAM,MAAM,GAAG;AACb,QAAA,GAAG,EAAE,QAAQ;AACb,QAAA,GAAG,EAAE;KACN;;IAGD,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;;AAG3D,IAAA,MAAM,OAAO,GAAG,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,UAAU,EAAE;AAE5C,IAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE;AAC3C;AAEA;;;;;;;AAOG;AACG,SAAU,iBAAiB,CAAC,MAGjC,EAAA;;;;AAIC,IAAA,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS;AAChC,IAAA,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;AAC9B,QAAA,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC;;AAGA,IAAA,IAAI,SAAS,CAAC,MAAM,KAAK,GAAG,EAAE;QAC5B,MAAM,IAAI,KAAK,CAAC,CAAA,sDAAA,EAAyD,SAAS,CAAC,MAAM,CAAA,CAAE,CAAC;IAC9F;;IAGA,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC;IACrC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC;;AAGtC,IAAA,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;AAC/B,IAAA,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;;AAGhC,IAAA,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE,GAAG,KAAK,GAAG,EAAE,GAAG,KAAK;;AAGpD,IAAA,MAAM,cAAc,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC;AACzC,IAAA,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,IAAA,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;AAC9B,IAAA,cAAc,CAAC,EAAE,CAAC,GAAG,WAAW;;AAGhC,IAAA,MAAM,YAAY,GAAG,oBAAoB,CAAC,cAAc,CAAC;;AAGzD,IAAA,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA,CAAA,EAAI,YAAY,EAAE;AAC5C;AAEA;;AAEG;AACH,SAAS,eAAe,CAAC,GAAW,EAAA;;IAElC,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;AAC3C,IAAA,OAAO,oBAAoB,CAAC,KAAK,CAAC;AACpC;AAEA;;AAEG;AACH,SAAS,oBAAoB,CAAC,KAAiB,EAAA;;IAE7C,IAAI,MAAM,GAAG,EAAE;AACf,IAAA,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE;;AAEjC,QAAA,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAChD;SAAO;;QAEL,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1E,QAAA,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACvB;;AAGA,IAAA,OAAO;AACJ,SAAA,OAAO,CAAC,KAAK,EAAE,GAAG;AAClB,SAAA,OAAO,CAAC,KAAK,EAAE,GAAG;AAClB,SAAA,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;AACtB;AAEA;;AAEG;AACH,SAAS,UAAU,CAAC,GAAW,EAAA;IAC7B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5C,IAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QACtC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;IAClD;AACA,IAAA,OAAO,KAAK;AACd;;;;"}