@vinaystwt/xmpp-payment-adapters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xMPP 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/dist/config/src/index.d.ts

@@ -0,0 +1,49 @@
+export declare const config: {
+    readonly nodeEnv: string;
+    readonly network: string;
+    readonly paymentExecutionMode: "mock" | "testnet";
+    readonly rpcUrl: string;
+    readonly networkPassphrase: string;
+    readonly gatewayPort: number;
+    readonly dashboardPort: number;
+    readonly dashboardGatewayUrl: string | undefined;
+    readonly dailyBudgetUsd: number;
+    readonly facilitatorUrl: string;
+    readonly wallet: {
+        readonly agentSecretKey: string | undefined;
+        readonly smartAccountContractId: string | undefined;
+        readonly smartAccountWasmHash: string;
+        readonly webauthnVerifierAddress: string;
+        readonly ed25519VerifierAddress: string;
+        readonly spendingLimitPolicyAddress: string;
+        readonly thresholdPolicyAddress: string;
+    };
+    readonly x402: {
+        readonly facilitatorUrl: string;
+        readonly facilitatorApiKey: string | undefined;
+        readonly maxTransactionFeeStroops: number;
+        readonly facilitatorPrivateKey: string | undefined;
+        readonly recipientAddress: string | undefined;
+    };
+    readonly mpp: {
+        readonly secretKey: string | undefined;
+        readonly recipientAddress: string | undefined;
+        readonly channelContractId: string | undefined;
+        readonly feeSponsorshipEnabled: boolean;
+        readonly feeSponsorship: {
+            readonly chargeEnabled: boolean;
+            readonly sessionEnabled: boolean;
+        };
+        readonly feeSponsorSecretKey: string | undefined;
+        readonly feeBumpSecretKey: string | undefined;
+    };
+    readonly services: {
+        readonly research: string;
+        readonly market: string;
+        readonly stream: string;
+    };
+    readonly contracts: {
+        readonly policyContractId: string | undefined;
+        readonly sessionRegistryContractId: string | undefined;
+    };
+};

package/dist/config/src/index.js

@@ -0,0 +1,117 @@
+import { config as loadEnv } from 'dotenv';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { z } from 'zod';
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(moduleDir, '../../../');
+loadEnv({ path: resolve(repoRoot, '.env') });
+loadEnv({ path: resolve(repoRoot, '.env.local'), override: true });
+loadEnv();
+const envSchema = z.object({
+    NODE_ENV: z.string().default('development'),
+    XMPP_NETWORK: z.string().default('stellar:testnet'),
+    XMPP_PAYMENT_EXECUTION_MODE: z.enum(['mock', 'testnet']).default('mock'),
+    XMPP_RPC_URL: z.string().default('https://soroban-testnet.stellar.org'),
+    XMPP_NETWORK_PASSPHRASE: z.string().default('Test SDF Network ; September 2015'),
+    XMPP_GATEWAY_PORT: z.coerce.number().default(4300),
+    XMPP_DASHBOARD_PORT: z.coerce.number().default(4310),
+    XMPP_DASHBOARD_GATEWAY_URL: z.string().optional(),
+    XMPP_DAILY_BUDGET_USD: z.coerce.number().default(0.5),
+    XMPP_AGENT_SECRET_KEY: z.string().optional(),
+    XMPP_SMART_ACCOUNT_CONTRACT_ID: z.string().optional(),
+    XMPP_SMART_ACCOUNT_WASM_HASH: z
+        .string()
+        .default('3e51f5b222dec74650f0b33367acb42a41ce497f72639230463070e666abba2c'),
+    XMPP_WEBAUTHN_VERIFIER_ADDRESS: z
+        .string()
+        .default('CATPTBRWVMH5ZCIKO5HN2F4FMPXVZEXC56RKGHRXCM7EEZGGXK7PICEH'),
+    XMPP_ED25519_VERIFIER_ADDRESS: z
+        .string()
+        .default('CAIKK32K3BZJYTWVTXHZFPIEEDBR6YCVTGPABH4UQUQ4XFA3OLYXG27G'),
+    XMPP_SPENDING_LIMIT_POLICY_ADDRESS: z
+        .string()
+        .default('CBYLPYZGLQ6JVY2IQ5P23QLQPR3KAMMKMZLNWG6RUUKJDNYGPLVHK7U4'),
+    XMPP_THRESHOLD_POLICY_ADDRESS: z
+        .string()
+        .default('CDDQLFG7CV74QHWPSP6NZIPNBR2PPCMTUVYCJF4P3ONDYHODRFGR7LWC'),
+    X402_FACILITATOR_URL: z.string().default('http://localhost:4022'),
+    X402_FACILITATOR_API_KEY: z.string().optional(),
+    X402_MAX_TRANSACTION_FEE_STROOPS: z.coerce.number().default(2000000),
+    X402_RECIPIENT_ADDRESS: z.string().optional(),
+    FACILITATOR_STELLAR_PRIVATE_KEY: z.string().optional(),
+    MPP_SECRET_KEY: z.string().optional(),
+    MPP_RECIPIENT_ADDRESS: z.string().optional(),
+    MPP_CHANNEL_CONTRACT_ID: z.string().optional(),
+    XMPP_ENABLE_MPP_FEE_SPONSORSHIP: z
+        .enum(['true', 'false'])
+        .default('false')
+        .transform((value) => value === 'true'),
+    XMPP_ENABLE_MPP_CHARGE_FEE_SPONSORSHIP: z
+        .enum(['true', 'false'])
+        .optional()
+        .transform((value) => value === 'true'),
+    XMPP_ENABLE_MPP_SESSION_FEE_SPONSORSHIP: z
+        .enum(['true', 'false'])
+        .optional()
+        .transform((value) => value === 'true'),
+    XMPP_MPP_FEE_SPONSOR_SECRET_KEY: z.string().optional(),
+    XMPP_MPP_FEE_BUMP_SECRET_KEY: z.string().optional(),
+    XMPP_RESEARCH_API_URL: z.string().default('http://localhost:4101'),
+    XMPP_MARKET_API_URL: z.string().default('http://localhost:4102'),
+    XMPP_STREAM_API_URL: z.string().default('http://localhost:4103'),
+    XMPP_POLICY_CONTRACT_ID: z.string().optional(),
+    XMPP_SESSION_REGISTRY_CONTRACT_ID: z.string().optional(),
+});
+const env = envSchema.parse(process.env);
+const mppFeeSponsorshipEnabled = env.XMPP_ENABLE_MPP_FEE_SPONSORSHIP;
+const mppChargeFeeSponsorshipEnabled = env.XMPP_ENABLE_MPP_CHARGE_FEE_SPONSORSHIP ?? mppFeeSponsorshipEnabled;
+const mppSessionFeeSponsorshipEnabled = env.XMPP_ENABLE_MPP_SESSION_FEE_SPONSORSHIP ?? mppFeeSponsorshipEnabled;
+export const config = {
+    nodeEnv: env.NODE_ENV,
+    network: env.XMPP_NETWORK,
+    paymentExecutionMode: env.XMPP_PAYMENT_EXECUTION_MODE,
+    rpcUrl: env.XMPP_RPC_URL,
+    networkPassphrase: env.XMPP_NETWORK_PASSPHRASE,
+    gatewayPort: env.XMPP_GATEWAY_PORT,
+    dashboardPort: env.XMPP_DASHBOARD_PORT,
+    dashboardGatewayUrl: env.XMPP_DASHBOARD_GATEWAY_URL,
+    dailyBudgetUsd: env.XMPP_DAILY_BUDGET_USD,
+    facilitatorUrl: env.X402_FACILITATOR_URL,
+    wallet: {
+        agentSecretKey: env.XMPP_AGENT_SECRET_KEY,
+        smartAccountContractId: env.XMPP_SMART_ACCOUNT_CONTRACT_ID,
+        smartAccountWasmHash: env.XMPP_SMART_ACCOUNT_WASM_HASH,
+        webauthnVerifierAddress: env.XMPP_WEBAUTHN_VERIFIER_ADDRESS,
+        ed25519VerifierAddress: env.XMPP_ED25519_VERIFIER_ADDRESS,
+        spendingLimitPolicyAddress: env.XMPP_SPENDING_LIMIT_POLICY_ADDRESS,
+        thresholdPolicyAddress: env.XMPP_THRESHOLD_POLICY_ADDRESS,
+    },
+    x402: {
+        facilitatorUrl: env.X402_FACILITATOR_URL,
+        facilitatorApiKey: env.X402_FACILITATOR_API_KEY,
+        maxTransactionFeeStroops: env.X402_MAX_TRANSACTION_FEE_STROOPS,
+        facilitatorPrivateKey: env.FACILITATOR_STELLAR_PRIVATE_KEY,
+        recipientAddress: env.X402_RECIPIENT_ADDRESS,
+    },
+    mpp: {
+        secretKey: env.MPP_SECRET_KEY,
+        recipientAddress: env.MPP_RECIPIENT_ADDRESS,
+        channelContractId: env.MPP_CHANNEL_CONTRACT_ID,
+        feeSponsorshipEnabled: mppFeeSponsorshipEnabled,
+        feeSponsorship: {
+            chargeEnabled: mppChargeFeeSponsorshipEnabled,
+            sessionEnabled: mppSessionFeeSponsorshipEnabled,
+        },
+        feeSponsorSecretKey: env.XMPP_MPP_FEE_SPONSOR_SECRET_KEY,
+        feeBumpSecretKey: env.XMPP_MPP_FEE_BUMP_SECRET_KEY,
+    },
+    services: {
+        research: env.XMPP_RESEARCH_API_URL,
+        market: env.XMPP_MARKET_API_URL,
+        stream: env.XMPP_STREAM_API_URL,
+    },
+    contracts: {
+        policyContractId: env.XMPP_POLICY_CONTRACT_ID,
+        sessionRegistryContractId: env.XMPP_SESSION_REGISTRY_CONTRACT_ID,
+    },
+};

package/dist/payment-adapters/src/index.d.ts

@@ -0,0 +1,27 @@
+import { Keypair, xdr } from '@stellar/stellar-sdk';
+import type { PaymentChallenge, PaymentExecutionMetadata, PaymentExecutionResult, RouteKind } from '@xmpp/types';
+import { XLM_SAC_TESTNET } from '@stellar/mpp';
+declare function createClassicSignatureScVal(keypair: Keypair, payload: Buffer): xdr.ScVal;
+declare function createDelegatedSignerScVal(publicKey: string): xdr.ScVal;
+declare function createDelegatedAuthPayload(publicKey: string, contextRuleIds: number[]): xdr.ScVal;
+declare function buildSmartAccountSignaturePayload(entry: xdr.SorobanAuthorizationEntry, networkPassphrase: string): Buffer<ArrayBufferLike>;
+declare function buildSmartAccountAuthDigest(signaturePayload: Buffer, contextRuleIds: number[]): Buffer<ArrayBufferLike>;
+declare function signDelegatedSmartAccountAuth(authEntries: xdr.SorobanAuthorizationEntry[], smartAccountContractId: string, delegatedSigner: Keypair, expiration: number, networkPassphrase: string, contextRuleIds?: number[]): xdr.SorobanAuthorizationEntry[];
+export declare const __smartAccountTestUtils: {
+    createClassicSignatureScVal: typeof createClassicSignatureScVal;
+    createDelegatedSignerScVal: typeof createDelegatedSignerScVal;
+    createDelegatedAuthPayload: typeof createDelegatedAuthPayload;
+    buildSmartAccountSignaturePayload: typeof buildSmartAccountSignaturePayload;
+    buildSmartAccountAuthDigest: typeof buildSmartAccountAuthDigest;
+    signDelegatedSmartAccountAuth: typeof signDelegatedSmartAccountAuth;
+};
+export declare function buildRetryHeaders(challenge: PaymentChallenge, route: RouteKind): {
+    [challenge.retryHeaderName]: string;
+    'x-xmpp-route': RouteKind;
+};
+export declare function preparePaymentExecution(challenge: PaymentChallenge, route: RouteKind): {
+    headers: Record<string, string>;
+    metadata: PaymentExecutionMetadata;
+};
+export declare function executePaymentRoute(route: RouteKind, input: RequestInfo | URL, init?: RequestInit): Promise<PaymentExecutionResult>;
+export { XLM_SAC_TESTNET };