uvd-x402-sdk 2.6.0 → 2.10.0

package/dist/providers/algorand/index.d.mts

@@ -0,0 +1,86 @@
+import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, l as X402Version } from '../../index-D-dO_FoP.mjs';
+
+/**
+ * uvd-x402-sdk - Algorand Provider
+ *
+ * Provides wallet connection and payment creation for Algorand via Pera Wallet.
+ * Uses ASA (Algorand Standard Assets) transfers for USDC payments.
+ *
+ * USDC ASA IDs:
+ * - Mainnet: 31566704
+ * - Testnet: 10458941
+ *
+ * @example
+ * ```ts
+ * import { AlgorandProvider } from 'uvd-x402-sdk/algorand';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const algorand = new AlgorandProvider();
+ *
+ * // Connect to Pera Wallet
+ * const address = await algorand.connect();
+ *
+ * // Create Algorand payment
+ * const chainConfig = getChainByName('algorand')!;
+ * const paymentPayload = await algorand.signPayment(paymentInfo, chainConfig);
+ * const header = algorand.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ */
+
+/**
+ * AlgorandProvider - Wallet adapter for Algorand via Pera Wallet
+ *
+ * Supports both mainnet and testnet through chain configuration.
+ */
+declare class AlgorandProvider implements WalletAdapter {
+    readonly id = "pera";
+    readonly name = "Pera Wallet";
+    readonly networkType: "algorand";
+    private peraWallet;
+    private address;
+    private algodClients;
+    /**
+     * Check if Pera Wallet is available
+     * Note: Pera works as a WalletConnect modal, so it's always "available"
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to Pera Wallet
+     */
+    connect(_chainName?: string): Promise<string>;
+    /**
+     * Disconnect from Pera Wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current address
+     */
+    getAddress(): string | null;
+    /**
+     * Get USDC (ASA) balance
+     */
+    getBalance(chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Create Algorand ASA transfer payment
+     *
+     * Transaction structure:
+     * 1. ASA Transfer from user to recipient
+     * 2. Facilitator pays transaction fees
+     */
+    signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Encode Algorand payment as X-PAYMENT header
+     *
+     * @param paymentPayload - JSON-encoded payment payload from signPayment()
+     * @param chainConfig - Chain configuration
+     * @param version - x402 protocol version (1 or 2, defaults to 1)
+     * @returns Base64-encoded X-PAYMENT header value
+     */
+    encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig, version?: X402Version): string;
+    /**
+     * Get or create an Algod client for a specific chain
+     */
+    private getAlgodClient;
+}
+
+export { AlgorandProvider, AlgorandProvider as default };

package/dist/providers/algorand/index.d.ts

@@ -0,0 +1,86 @@
+import { c as WalletAdapter, C as ChainConfig, P as PaymentInfo, l as X402Version } from '../../index-D-dO_FoP.js';
+
+/**
+ * uvd-x402-sdk - Algorand Provider
+ *
+ * Provides wallet connection and payment creation for Algorand via Pera Wallet.
+ * Uses ASA (Algorand Standard Assets) transfers for USDC payments.
+ *
+ * USDC ASA IDs:
+ * - Mainnet: 31566704
+ * - Testnet: 10458941
+ *
+ * @example
+ * ```ts
+ * import { AlgorandProvider } from 'uvd-x402-sdk/algorand';
+ * import { getChainByName } from 'uvd-x402-sdk';
+ *
+ * const algorand = new AlgorandProvider();
+ *
+ * // Connect to Pera Wallet
+ * const address = await algorand.connect();
+ *
+ * // Create Algorand payment
+ * const chainConfig = getChainByName('algorand')!;
+ * const paymentPayload = await algorand.signPayment(paymentInfo, chainConfig);
+ * const header = algorand.encodePaymentHeader(paymentPayload, chainConfig);
+ * ```
+ */
+
+/**
+ * AlgorandProvider - Wallet adapter for Algorand via Pera Wallet
+ *
+ * Supports both mainnet and testnet through chain configuration.
+ */
+declare class AlgorandProvider implements WalletAdapter {
+    readonly id = "pera";
+    readonly name = "Pera Wallet";
+    readonly networkType: "algorand";
+    private peraWallet;
+    private address;
+    private algodClients;
+    /**
+     * Check if Pera Wallet is available
+     * Note: Pera works as a WalletConnect modal, so it's always "available"
+     */
+    isAvailable(): boolean;
+    /**
+     * Connect to Pera Wallet
+     */
+    connect(_chainName?: string): Promise<string>;
+    /**
+     * Disconnect from Pera Wallet
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Get current address
+     */
+    getAddress(): string | null;
+    /**
+     * Get USDC (ASA) balance
+     */
+    getBalance(chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Create Algorand ASA transfer payment
+     *
+     * Transaction structure:
+     * 1. ASA Transfer from user to recipient
+     * 2. Facilitator pays transaction fees
+     */
+    signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
+    /**
+     * Encode Algorand payment as X-PAYMENT header
+     *
+     * @param paymentPayload - JSON-encoded payment payload from signPayment()
+     * @param chainConfig - Chain configuration
+     * @param version - x402 protocol version (1 or 2, defaults to 1)
+     * @returns Base64-encoded X-PAYMENT header value
+     */
+    encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig, version?: X402Version): string;
+    /**
+     * Get or create an Algod client for a specific chain
+     */
+    private getAlgodClient;
+}
+
+export { AlgorandProvider, AlgorandProvider as default };