@t402/polkadot 2.3.0

package/README.md

@@ -0,0 +1,139 @@
+# @t402/polkadot
+
+Polkadot Asset Hub implementation of the t402 payment protocol using the **exact-direct** payment scheme with Assets Pallet transfers.
+
+## Installation
+
+```bash
+npm install @t402/polkadot
+# or
+pnpm add @t402/polkadot
+```
+
+## Overview
+
+This package provides support for USDT payments on Polkadot Asset Hub parachains using the exact-direct scheme. The client executes the transfer directly on-chain, then provides the extrinsic hash as proof of payment.
+
+Three main components:
+
+- **Client** - For applications that make payments (have Polkadot wallets)
+- **Facilitator** - For payment processors that verify extrinsics via Subscan
+- **Server** - For resource servers that accept payments and build payment requirements
+
+## Supported Networks
+
+| Network | CAIP-2 Identifier | Asset ID | Status |
+|---------|-------------------|----------|--------|
+| Polkadot Asset Hub | `polkadot:68d56f15f85d3136970ec16946040bc1` | 1984 | Production |
+| Kusama Asset Hub | `polkadot:48239ef607d7928...` | 1984 | Production |
+| Westend Asset Hub | `polkadot:e143f23803ac50e8f6f8e62695d1ce9e` | 1984 | Testnet |
+
+## Package Exports
+
+### Main Package (`@t402/polkadot`)
+
+**Constants:**
+- `POLKADOT_ASSET_HUB_CAIP2` - CAIP-2 identifier for Polkadot Asset Hub
+- `KUSAMA_ASSET_HUB_CAIP2` - CAIP-2 identifier for Kusama Asset Hub
+- `WESTEND_ASSET_HUB_CAIP2` - CAIP-2 identifier for Westend testnet
+- `POLKADOT_NETWORKS` - Array of supported networks
+- `getNetworkConfig(network)` - Get network configuration
+
+**Tokens:**
+- `USDT_POLKADOT` - USDT token config (Asset ID: 1984)
+- `TOKEN_REGISTRY` - Token configurations by network
+- `getTokenConfig(network, symbol)` - Get token by symbol
+- `getDefaultToken(network)` - Get default token for network
+
+**Utilities:**
+- `isValidAddress(address)` - Validate SS58 address format
+- `isValidExtrinsicHash(hash)` - Validate extrinsic hash format
+- `compareAddresses(addr1, addr2)` - Compare two addresses
+- `formatAmount(amount, decimals)` - Format for display
+- `parseAmount(amount, decimals)` - Parse to smallest units
+- `extractAssetTransfer(extrinsic)` - Extract transfer details
+
+### Client (`@t402/polkadot/exact-direct/client`)
+
+```typescript
+import { createExactDirectPolkadotClient } from '@t402/polkadot/exact-direct/client';
+
+const client = createExactDirectPolkadotClient({
+  signer: myPolkadotSigner,
+});
+```
+
+### Server (`@t402/polkadot/exact-direct/server`)
+
+```typescript
+import { registerExactDirectPolkadotServer } from '@t402/polkadot/exact-direct/server';
+
+registerExactDirectPolkadotServer(server);
+```
+
+### Facilitator (`@t402/polkadot/exact-direct/facilitator`)
+
+```typescript
+import { createExactDirectPolkadotFacilitator } from '@t402/polkadot/exact-direct/facilitator';
+
+const facilitator = createExactDirectPolkadotFacilitator(signer);
+```
+
+## Payment Flow
+
+1. **Client** requests protected resource
+2. **Server** responds with 402 + payment requirements (network, amount, payTo)
+3. **Client** executes `assets.transfer` extrinsic on Polkadot Asset Hub
+4. **Client** submits extrinsic hash as payment proof
+5. **Facilitator** queries Subscan API to verify the extrinsic
+6. **Facilitator** confirms payment matches requirements
+
+## Payload Structure
+
+```typescript
+interface ExactDirectPolkadotPayload {
+  extrinsicHash: string;    // 0x-prefixed extrinsic hash
+  blockHash: string;        // 0x-prefixed block hash
+  extrinsicIndex: number;   // Index within block
+  from: string;             // Sender SS58 address
+  to: string;               // Recipient SS58 address
+  amount: string;           // Amount in smallest units
+  assetId: number;          // Asset ID (1984 for USDT)
+}
+```
+
+## Address Format
+
+Polkadot uses SS58 addresses:
+- 45-50 characters
+- Base58 encoded (no 0, O, I, l)
+- Network-specific prefixes (0 for Polkadot, 2 for Kusama, 42 for generic)
+
+Examples:
+```
+15oF4uVJwmo4TdGW7VfQxNLavjCXviqxT9S1MgbjMNHr6Sp5  (Polkadot)
+HNZata7iMYWmk5RvZRTiAsSDhV8366zq2YGb3tLH5Upf74F  (Kusama)
+```
+
+## Development
+
+```bash
+# Build
+pnpm build
+
+# Test
+pnpm test
+
+# Test with coverage
+pnpm test:coverage
+
+# Lint
+pnpm lint
+```
+
+## Related Packages
+
+- `@t402/core` - Core protocol types and client
+- `@t402/fetch` - HTTP wrapper with automatic payment handling
+- `@t402/evm` - EVM chains implementation
+- `@t402/tezos` - Tezos implementation

package/dist/exact-direct/client/index.cjs

@@ -0,0 +1,189 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/exact-direct/client/index.ts
+var client_exports = {};
+__export(client_exports, {
+  ExactDirectPolkadotClient: () => ExactDirectPolkadotClient,
+  createExactDirectPolkadotClient: () => createExactDirectPolkadotClient
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/constants.ts
+var POLKADOT_CAIP2_NAMESPACE = "polkadot";
+var POLKADOT_ASSET_HUB_CAIP2 = "polkadot:68d56f15f85d3136970ec16946040bc1";
+var KUSAMA_ASSET_HUB_CAIP2 = "polkadot:48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a";
+var WESTEND_ASSET_HUB_CAIP2 = "polkadot:e143f23803ac50e8f6f8e62695d1ce9e";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var DEFAULT_POLKADOT_INDEXER = "https://assethub-polkadot.api.subscan.io";
+var DEFAULT_KUSAMA_INDEXER = "https://assethub-kusama.api.subscan.io";
+var DEFAULT_WESTEND_INDEXER = "https://assethub-westend.api.subscan.io";
+var DEFAULT_POLKADOT_RPC = "wss://polkadot-asset-hub-rpc.polkadot.io";
+var DEFAULT_KUSAMA_RPC = "wss://kusama-asset-hub-rpc.polkadot.io";
+var DEFAULT_WESTEND_RPC = "wss://westend-asset-hub-rpc.polkadot.io";
+var POLKADOT_NETWORKS = {
+  [POLKADOT_ASSET_HUB_CAIP2]: {
+    name: "Polkadot Asset Hub",
+    caip2: POLKADOT_ASSET_HUB_CAIP2,
+    rpcUrl: DEFAULT_POLKADOT_RPC,
+    indexerUrl: DEFAULT_POLKADOT_INDEXER,
+    genesisHash: "0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f",
+    ss58Prefix: 0,
+    // Polkadot
+    isTestnet: false
+  },
+  [KUSAMA_ASSET_HUB_CAIP2]: {
+    name: "Kusama Asset Hub",
+    caip2: KUSAMA_ASSET_HUB_CAIP2,
+    rpcUrl: DEFAULT_KUSAMA_RPC,
+    indexerUrl: DEFAULT_KUSAMA_INDEXER,
+    genesisHash: "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a",
+    ss58Prefix: 2,
+    // Kusama
+    isTestnet: false
+  },
+  [WESTEND_ASSET_HUB_CAIP2]: {
+    name: "Westend Asset Hub",
+    caip2: WESTEND_ASSET_HUB_CAIP2,
+    rpcUrl: DEFAULT_WESTEND_RPC,
+    indexerUrl: DEFAULT_WESTEND_INDEXER,
+    genesisHash: "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
+    ss58Prefix: 42,
+    // Generic Substrate
+    isTestnet: true
+  }
+};
+
+// src/tokens.ts
+var USDT_POLKADOT = {
+  assetId: 1984,
+  symbol: "USDT",
+  name: "Tether USD",
+  decimals: 6,
+  issuer: "Tether"
+};
+var USDT_KUSAMA = {
+  assetId: 1984,
+  symbol: "USDT",
+  name: "Tether USD",
+  decimals: 6,
+  issuer: "Tether"
+};
+var USDT_WESTEND = {
+  assetId: 1984,
+  symbol: "USDT",
+  name: "Test Tether USD",
+  decimals: 6
+};
+var TOKEN_REGISTRY = {
+  [POLKADOT_ASSET_HUB_CAIP2]: {
+    USDT: USDT_POLKADOT
+  },
+  [KUSAMA_ASSET_HUB_CAIP2]: {
+    USDT: USDT_KUSAMA
+  },
+  [WESTEND_ASSET_HUB_CAIP2]: {
+    USDT: USDT_WESTEND
+  }
+};
+var DEFAULT_TOKENS = {
+  [POLKADOT_ASSET_HUB_CAIP2]: USDT_POLKADOT,
+  [KUSAMA_ASSET_HUB_CAIP2]: USDT_KUSAMA,
+  [WESTEND_ASSET_HUB_CAIP2]: USDT_WESTEND
+};
+function getTokenConfig(network, symbol = "USDT") {
+  return TOKEN_REGISTRY[network]?.[symbol];
+}
+function getAssetId(network, symbol = "USDT") {
+  return getTokenConfig(network, symbol)?.assetId;
+}
+
+// src/utils.ts
+function isValidAddress(address) {
+  if (!address || typeof address !== "string") {
+    return false;
+  }
+  const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{45,50}$/;
+  return base58Regex.test(address);
+}
+
+// src/exact-direct/client/scheme.ts
+var ExactDirectPolkadotClient = class {
+  scheme = SCHEME_EXACT_DIRECT;
+  signer;
+  constructor(config) {
+    this.signer = config.signer;
+  }
+  /**
+   * Create a payment payload by executing the transfer
+   */
+  async createPaymentPayload(t402Version, requirements) {
+    this.validateRequirements(requirements);
+    const { network, amount, payTo, extra } = requirements;
+    const symbol = extra?.assetSymbol || "USDT";
+    const assetId = extra?.assetId ?? getAssetId(network, symbol);
+    if (assetId === void 0) {
+      throw new Error(`Unknown asset ${symbol} on network ${network}`);
+    }
+    const from = await this.signer.getAddress();
+    const { extrinsicHash, blockHash, extrinsicIndex } = await this.signer.transferAsset(assetId, payTo, amount);
+    const polkadotPayload = {
+      extrinsicHash,
+      blockHash,
+      extrinsicIndex,
+      from,
+      to: payTo,
+      amount,
+      assetId
+    };
+    return {
+      t402Version,
+      payload: polkadotPayload
+    };
+  }
+  /**
+   * Validate payment requirements
+   */
+  validateRequirements(requirements) {
+    if (requirements.scheme !== SCHEME_EXACT_DIRECT) {
+      throw new Error(
+        `Invalid scheme: expected ${SCHEME_EXACT_DIRECT}, got ${requirements.scheme}`
+      );
+    }
+    if (!requirements.network.startsWith(`${POLKADOT_CAIP2_NAMESPACE}:`)) {
+      throw new Error(`Invalid network: ${requirements.network}`);
+    }
+    if (!isValidAddress(requirements.payTo)) {
+      throw new Error(`Invalid payTo address: ${requirements.payTo}`);
+    }
+    const amount = BigInt(requirements.amount);
+    if (amount <= 0n) {
+      throw new Error(`Invalid amount: ${requirements.amount}`);
+    }
+  }
+};
+function createExactDirectPolkadotClient(config) {
+  return new ExactDirectPolkadotClient(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ExactDirectPolkadotClient,
+  createExactDirectPolkadotClient
+});
+//# sourceMappingURL=index.cjs.map

package/dist/exact-direct/client/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/exact-direct/client/index.ts","../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/client/scheme.ts"],"sourcesContent":["export {\n  ExactDirectPolkadotClient,\n  createExactDirectPolkadotClient,\n  type ExactDirectPolkadotClientConfig,\n} from \"./scheme.js\";\n","/**\n * Polkadot Asset Hub T402 Constants\n *\n * Polkadot Asset Hub (formerly Statemint) is a common-good parachain\n * that hosts assets like USDT on the Polkadot network.\n */\n\n// CAIP-2 namespace for Polkadot\nexport const POLKADOT_CAIP2_NAMESPACE = \"polkadot\";\n\n// CAIP-2 network identifiers (first 32 chars of genesis hash)\n// Polkadot Asset Hub (Parachain ID: 1000)\nexport const POLKADOT_ASSET_HUB_CAIP2 = \"polkadot:68d56f15f85d3136970ec16946040bc1\";\n\n// Kusama Asset Hub (Parachain ID: 1000 on Kusama)\nexport const KUSAMA_ASSET_HUB_CAIP2 = \"polkadot:48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\";\n\n// Westend Asset Hub (Testnet)\nexport const WESTEND_ASSET_HUB_CAIP2 = \"polkadot:e143f23803ac50e8f6f8e62695d1ce9e\";\n\n// Scheme identifier\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// Default indexers (Subscan API)\nexport const DEFAULT_POLKADOT_INDEXER = \"https://assethub-polkadot.api.subscan.io\";\nexport const DEFAULT_KUSAMA_INDEXER = \"https://assethub-kusama.api.subscan.io\";\nexport const DEFAULT_WESTEND_INDEXER = \"https://assethub-westend.api.subscan.io\";\n\n// Default RPC endpoints\nexport const DEFAULT_POLKADOT_RPC = \"wss://polkadot-asset-hub-rpc.polkadot.io\";\nexport const DEFAULT_KUSAMA_RPC = \"wss://kusama-asset-hub-rpc.polkadot.io\";\nexport const DEFAULT_WESTEND_RPC = \"wss://westend-asset-hub-rpc.polkadot.io\";\n\n// Network configurations\nexport interface PolkadotNetworkConfig {\n  readonly name: string;\n  readonly caip2: string;\n  readonly rpcUrl: string;\n  readonly indexerUrl: string;\n  readonly genesisHash: string;\n  readonly ss58Prefix: number;\n  readonly isTestnet: boolean;\n}\n\nexport const POLKADOT_NETWORKS: Record<string, PolkadotNetworkConfig> = {\n  [POLKADOT_ASSET_HUB_CAIP2]: {\n    name: \"Polkadot Asset Hub\",\n    caip2: POLKADOT_ASSET_HUB_CAIP2,\n    rpcUrl: DEFAULT_POLKADOT_RPC,\n    indexerUrl: DEFAULT_POLKADOT_INDEXER,\n    genesisHash: \"0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f\",\n    ss58Prefix: 0, // Polkadot\n    isTestnet: false,\n  },\n  [KUSAMA_ASSET_HUB_CAIP2]: {\n    name: \"Kusama Asset Hub\",\n    caip2: KUSAMA_ASSET_HUB_CAIP2,\n    rpcUrl: DEFAULT_KUSAMA_RPC,\n    indexerUrl: DEFAULT_KUSAMA_INDEXER,\n    genesisHash: \"0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\",\n    ss58Prefix: 2, // Kusama\n    isTestnet: false,\n  },\n  [WESTEND_ASSET_HUB_CAIP2]: {\n    name: \"Westend Asset Hub\",\n    caip2: WESTEND_ASSET_HUB_CAIP2,\n    rpcUrl: DEFAULT_WESTEND_RPC,\n    indexerUrl: DEFAULT_WESTEND_INDEXER,\n    genesisHash: \"0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e\",\n    ss58Prefix: 42, // Generic Substrate\n    isTestnet: true,\n  },\n};\n\n/**\n * Get network configuration by CAIP-2 identifier\n */\nexport function getNetworkConfig(network: string): PolkadotNetworkConfig | undefined {\n  return POLKADOT_NETWORKS[network];\n}\n\n/**\n * Check if a network identifier is a Polkadot network\n */\nexport function isPolkadotNetwork(network: string): boolean {\n  return network.startsWith(`${POLKADOT_CAIP2_NAMESPACE}:`);\n}\n","/**\n * Polkadot Asset Hub Token Registry\n *\n * On Polkadot Asset Hub, tokens are identified by Asset IDs.\n * USDT is Asset ID 1984, created by Tether.\n */\n\nimport {\n  POLKADOT_ASSET_HUB_CAIP2,\n  KUSAMA_ASSET_HUB_CAIP2,\n  WESTEND_ASSET_HUB_CAIP2,\n} from \"./constants.js\";\n\n/**\n * Token configuration for Polkadot Asset Hub\n */\nexport interface TokenConfig {\n  /** Asset ID on Asset Hub */\n  readonly assetId: number;\n  /** Token symbol */\n  readonly symbol: string;\n  /** Token name */\n  readonly name: string;\n  /** Decimal places */\n  readonly decimals: number;\n  /** Issuer (creator of the asset) */\n  readonly issuer?: string;\n}\n\n/**\n * USDT on Polkadot Asset Hub\n * Asset ID: 1984\n * Decimals: 6\n */\nexport const USDT_POLKADOT: TokenConfig = {\n  assetId: 1984,\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: 6,\n  issuer: \"Tether\",\n};\n\n/**\n * USDT on Kusama Asset Hub\n * Asset ID: 1984 (same as Polkadot)\n */\nexport const USDT_KUSAMA: TokenConfig = {\n  assetId: 1984,\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: 6,\n  issuer: \"Tether\",\n};\n\n/**\n * Test USDT on Westend Asset Hub (testnet)\n */\nexport const USDT_WESTEND: TokenConfig = {\n  assetId: 1984,\n  symbol: \"USDT\",\n  name: \"Test Tether USD\",\n  decimals: 6,\n};\n\n/**\n * Network-specific token registries\n */\nexport const TOKEN_REGISTRY: Record<string, Record<string, TokenConfig>> = {\n  [POLKADOT_ASSET_HUB_CAIP2]: {\n    USDT: USDT_POLKADOT,\n  },\n  [KUSAMA_ASSET_HUB_CAIP2]: {\n    USDT: USDT_KUSAMA,\n  },\n  [WESTEND_ASSET_HUB_CAIP2]: {\n    USDT: USDT_WESTEND,\n  },\n};\n\n/**\n * Default tokens per network\n */\nexport const DEFAULT_TOKENS: Record<string, TokenConfig> = {\n  [POLKADOT_ASSET_HUB_CAIP2]: USDT_POLKADOT,\n  [KUSAMA_ASSET_HUB_CAIP2]: USDT_KUSAMA,\n  [WESTEND_ASSET_HUB_CAIP2]: USDT_WESTEND,\n};\n\n/**\n * Get token configuration by network and symbol\n */\nexport function getTokenConfig(\n  network: string,\n  symbol: string = \"USDT\",\n): TokenConfig | undefined {\n  return TOKEN_REGISTRY[network]?.[symbol];\n}\n\n/**\n * Get the default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  return DEFAULT_TOKENS[network];\n}\n\n/**\n * Get asset ID for a token on a network\n */\nexport function getAssetId(network: string, symbol: string = \"USDT\"): number | undefined {\n  return getTokenConfig(network, symbol)?.assetId;\n}\n","/**\n * Polkadot Asset Hub Utility Functions\n */\n\nimport type { PolkadotExtrinsicResult, ParsedAssetTransfer } from \"./types.js\";\n\n/**\n * Validate a Polkadot SS58 address format\n * SS58 addresses are base58-encoded with a checksum\n */\nexport function isValidAddress(address: string): boolean {\n  if (!address || typeof address !== \"string\") {\n    return false;\n  }\n\n  // SS58 addresses typically start with 1 (Polkadot), or have other prefixes\n  // Length is typically 47-48 characters for Polkadot addresses\n  // For a simple validation, check base58 characters and length\n  const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{45,50}$/;\n  return base58Regex.test(address);\n}\n\n/**\n * Validate an extrinsic hash format\n * Extrinsic hashes are 32-byte hex strings prefixed with 0x\n */\nexport function isValidExtrinsicHash(hash: string): boolean {\n  if (!hash || typeof hash !== \"string\") {\n    return false;\n  }\n  return /^0x[a-fA-F0-9]{64}$/.test(hash);\n}\n\n/**\n * Validate a block hash format\n */\nexport function isValidBlockHash(hash: string): boolean {\n  return isValidExtrinsicHash(hash); // Same format\n}\n\n/**\n * Compare two SS58 addresses (case-sensitive)\n */\nexport function compareAddresses(addr1: string, addr2: string): boolean {\n  return addr1 === addr2;\n}\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: string, decimals: number): string {\n  const amountBigInt = BigInt(amount);\n  const divisor = BigInt(10 ** decimals);\n  const wholePart = amountBigInt / divisor;\n  const fractionalPart = amountBigInt % divisor;\n\n  if (fractionalPart === 0n) {\n    return wholePart.toString();\n  }\n\n  const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n  const trimmedFractional = fractionalStr.replace(/0+$/, \"\");\n  return `${wholePart}.${trimmedFractional}`;\n}\n\n/**\n * Parse an amount string to the smallest unit (with decimals applied)\n */\nexport function parseAmount(amount: string, decimals: number): string {\n  const parts = amount.split(\".\");\n  const wholePart = parts[0] || \"0\";\n  const fractionalPart = (parts[1] || \"\").padEnd(decimals, \"0\").slice(0, decimals);\n  return BigInt(wholePart + fractionalPart).toString();\n}\n\n/**\n * Extract asset transfer details from an extrinsic result\n */\nexport function extractAssetTransfer(\n  result: PolkadotExtrinsicResult,\n): ParsedAssetTransfer | null {\n  if (!result.success) {\n    return null;\n  }\n\n  // Check if this is an assets.transfer or assets.transferKeepAlive call\n  if (result.module !== \"assets\") {\n    return null;\n  }\n\n  if (result.call !== \"transfer\" && result.call !== \"transferKeepAlive\") {\n    return null;\n  }\n\n  // Extract transfer details from args\n  const assetId = result.args.id as number | undefined;\n  const to = result.args.target as string | undefined;\n  const amount = result.args.amount as string | undefined;\n\n  if (assetId === undefined || !to || !amount) {\n    return null;\n  }\n\n  return {\n    assetId,\n    from: result.signer,\n    to,\n    amount: amount.toString(),\n    success: true,\n  };\n}\n\n/**\n * Extract asset transfer from events (alternative method)\n */\nexport function extractAssetTransferFromEvents(\n  result: PolkadotExtrinsicResult,\n): ParsedAssetTransfer | null {\n  if (!result.success) {\n    return null;\n  }\n\n  // Look for assets.Transferred event\n  const transferEvent = result.events.find(\n    (e) => e.module === \"assets\" && e.name === \"Transferred\",\n  );\n\n  if (!transferEvent) {\n    return null;\n  }\n\n  const assetId = transferEvent.data.assetId as number | undefined;\n  const from = transferEvent.data.from as string | undefined;\n  const to = transferEvent.data.to as string | undefined;\n  const amount = transferEvent.data.amount as string | undefined;\n\n  if (assetId === undefined || !from || !to || !amount) {\n    return null;\n  }\n\n  return {\n    assetId,\n    from,\n    to,\n    amount: amount.toString(),\n    success: true,\n  };\n}\n\n/**\n * Build a unique extrinsic identifier from block hash and index\n */\nexport function buildExtrinsicId(blockHash: string, extrinsicIndex: number): string {\n  return `${blockHash}-${extrinsicIndex}`;\n}\n\n/**\n * Parse an extrinsic identifier back to components\n */\nexport function parseExtrinsicId(\n  extrinsicId: string,\n): { blockHash: string; extrinsicIndex: number } | null {\n  const lastDashIndex = extrinsicId.lastIndexOf(\"-\");\n  if (lastDashIndex === -1) {\n    return null;\n  }\n\n  const blockHash = extrinsicId.slice(0, lastDashIndex);\n  const extrinsicIndex = parseInt(extrinsicId.slice(lastDashIndex + 1), 10);\n\n  if (!isValidBlockHash(blockHash) || isNaN(extrinsicIndex)) {\n    return null;\n  }\n\n  return { blockHash, extrinsicIndex };\n}\n","/**\n * Polkadot Exact-Direct Client Scheme\n *\n * In the exact-direct scheme, the client executes the asset transfer directly\n * and provides the extrinsic hash as proof of payment.\n */\n\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@t402/core/types\";\nimport type { ClientPolkadotSigner, ExactDirectPolkadotPayload } from \"../../types.js\";\nimport { SCHEME_EXACT_DIRECT, POLKADOT_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport { getAssetId } from \"../../tokens.js\";\nimport { isValidAddress } from \"../../utils.js\";\n\n/**\n * Configuration for the exact-direct client\n */\nexport interface ExactDirectPolkadotClientConfig {\n  /** Signer for executing transactions */\n  signer: ClientPolkadotSigner;\n}\n\n/**\n * Exact-direct client scheme for Polkadot Asset Hub\n */\nexport class ExactDirectPolkadotClient implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private readonly signer: ClientPolkadotSigner;\n\n  constructor(config: ExactDirectPolkadotClientConfig) {\n    this.signer = config.signer;\n  }\n\n  /**\n   * Create a payment payload by executing the transfer\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    requirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n    // Validate requirements\n    this.validateRequirements(requirements);\n\n    const { network, amount, payTo, extra } = requirements;\n\n    // Get asset ID from extra or use default USDT\n    const symbol = (extra?.assetSymbol as string) || \"USDT\";\n    const assetId = (extra?.assetId as number) ?? getAssetId(network, symbol);\n\n    if (assetId === undefined) {\n      throw new Error(`Unknown asset ${symbol} on network ${network}`);\n    }\n\n    // Get sender address\n    const from = await this.signer.getAddress();\n\n    // Execute the transfer\n    const { extrinsicHash, blockHash, extrinsicIndex } =\n      await this.signer.transferAsset(assetId, payTo, amount);\n\n    // Build the payload\n    const polkadotPayload: ExactDirectPolkadotPayload = {\n      extrinsicHash,\n      blockHash,\n      extrinsicIndex,\n      from,\n      to: payTo,\n      amount,\n      assetId,\n    };\n\n    return {\n      t402Version,\n      payload: polkadotPayload,\n    };\n  }\n\n  /**\n   * Validate payment requirements\n   */\n  private validateRequirements(requirements: PaymentRequirements): void {\n    // Check scheme\n    if (requirements.scheme !== SCHEME_EXACT_DIRECT) {\n      throw new Error(\n        `Invalid scheme: expected ${SCHEME_EXACT_DIRECT}, got ${requirements.scheme}`,\n      );\n    }\n\n    // Check network\n    if (!requirements.network.startsWith(`${POLKADOT_CAIP2_NAMESPACE}:`)) {\n      throw new Error(`Invalid network: ${requirements.network}`);\n    }\n\n    // Check payTo address\n    if (!isValidAddress(requirements.payTo)) {\n      throw new Error(`Invalid payTo address: ${requirements.payTo}`);\n    }\n\n    // Check amount\n    const amount = BigInt(requirements.amount);\n    if (amount <= 0n) {\n      throw new Error(`Invalid amount: ${requirements.amount}`);\n    }\n  }\n}\n\n/**\n * Create an exact-direct client for Polkadot\n */\nexport function createExactDirectPolkadotClient(\n  config: ExactDirectPolkadotClientConfig,\n): ExactDirectPolkadotClient {\n  return new ExactDirectPolkadotClient(config);\n}\n"],"mappings":"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","names":[]}

package/dist/exact-direct/client/index.d.cts

@@ -0,0 +1,39 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { C as ClientPolkadotSigner } from '../../types-Dbjfcz2Y.cjs';
+
+/**
+ * Polkadot Exact-Direct Client Scheme
+ *
+ * In the exact-direct scheme, the client executes the asset transfer directly
+ * and provides the extrinsic hash as proof of payment.
+ */
+
+/**
+ * Configuration for the exact-direct client
+ */
+interface ExactDirectPolkadotClientConfig {
+    /** Signer for executing transactions */
+    signer: ClientPolkadotSigner;
+}
+/**
+ * Exact-direct client scheme for Polkadot Asset Hub
+ */
+declare class ExactDirectPolkadotClient implements SchemeNetworkClient {
+    readonly scheme = "exact-direct";
+    private readonly signer;
+    constructor(config: ExactDirectPolkadotClientConfig);
+    /**
+     * Create a payment payload by executing the transfer
+     */
+    createPaymentPayload(t402Version: number, requirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    /**
+     * Validate payment requirements
+     */
+    private validateRequirements;
+}
+/**
+ * Create an exact-direct client for Polkadot
+ */
+declare function createExactDirectPolkadotClient(config: ExactDirectPolkadotClientConfig): ExactDirectPolkadotClient;
+
+export { ExactDirectPolkadotClient, type ExactDirectPolkadotClientConfig, createExactDirectPolkadotClient };

package/dist/exact-direct/client/index.d.ts

@@ -0,0 +1,39 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayload } from '@t402/core/types';
+import { C as ClientPolkadotSigner } from '../../types-Dbjfcz2Y.js';
+
+/**
+ * Polkadot Exact-Direct Client Scheme
+ *
+ * In the exact-direct scheme, the client executes the asset transfer directly
+ * and provides the extrinsic hash as proof of payment.
+ */
+
+/**
+ * Configuration for the exact-direct client
+ */
+interface ExactDirectPolkadotClientConfig {
+    /** Signer for executing transactions */
+    signer: ClientPolkadotSigner;
+}
+/**
+ * Exact-direct client scheme for Polkadot Asset Hub
+ */
+declare class ExactDirectPolkadotClient implements SchemeNetworkClient {
+    readonly scheme = "exact-direct";
+    private readonly signer;
+    constructor(config: ExactDirectPolkadotClientConfig);
+    /**
+     * Create a payment payload by executing the transfer
+     */
+    createPaymentPayload(t402Version: number, requirements: PaymentRequirements): Promise<Pick<PaymentPayload, "t402Version" | "payload">>;
+    /**
+     * Validate payment requirements
+     */
+    private validateRequirements;
+}
+/**
+ * Create an exact-direct client for Polkadot
+ */
+declare function createExactDirectPolkadotClient(config: ExactDirectPolkadotClientConfig): ExactDirectPolkadotClient;
+
+export { ExactDirectPolkadotClient, type ExactDirectPolkadotClientConfig, createExactDirectPolkadotClient };

package/dist/exact-direct/client/index.mjs

@@ -0,0 +1,161 @@
+// src/constants.ts
+var POLKADOT_CAIP2_NAMESPACE = "polkadot";
+var POLKADOT_ASSET_HUB_CAIP2 = "polkadot:68d56f15f85d3136970ec16946040bc1";
+var KUSAMA_ASSET_HUB_CAIP2 = "polkadot:48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a";
+var WESTEND_ASSET_HUB_CAIP2 = "polkadot:e143f23803ac50e8f6f8e62695d1ce9e";
+var SCHEME_EXACT_DIRECT = "exact-direct";
+var DEFAULT_POLKADOT_INDEXER = "https://assethub-polkadot.api.subscan.io";
+var DEFAULT_KUSAMA_INDEXER = "https://assethub-kusama.api.subscan.io";
+var DEFAULT_WESTEND_INDEXER = "https://assethub-westend.api.subscan.io";
+var DEFAULT_POLKADOT_RPC = "wss://polkadot-asset-hub-rpc.polkadot.io";
+var DEFAULT_KUSAMA_RPC = "wss://kusama-asset-hub-rpc.polkadot.io";
+var DEFAULT_WESTEND_RPC = "wss://westend-asset-hub-rpc.polkadot.io";
+var POLKADOT_NETWORKS = {
+  [POLKADOT_ASSET_HUB_CAIP2]: {
+    name: "Polkadot Asset Hub",
+    caip2: POLKADOT_ASSET_HUB_CAIP2,
+    rpcUrl: DEFAULT_POLKADOT_RPC,
+    indexerUrl: DEFAULT_POLKADOT_INDEXER,
+    genesisHash: "0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f",
+    ss58Prefix: 0,
+    // Polkadot
+    isTestnet: false
+  },
+  [KUSAMA_ASSET_HUB_CAIP2]: {
+    name: "Kusama Asset Hub",
+    caip2: KUSAMA_ASSET_HUB_CAIP2,
+    rpcUrl: DEFAULT_KUSAMA_RPC,
+    indexerUrl: DEFAULT_KUSAMA_INDEXER,
+    genesisHash: "0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a",
+    ss58Prefix: 2,
+    // Kusama
+    isTestnet: false
+  },
+  [WESTEND_ASSET_HUB_CAIP2]: {
+    name: "Westend Asset Hub",
+    caip2: WESTEND_ASSET_HUB_CAIP2,
+    rpcUrl: DEFAULT_WESTEND_RPC,
+    indexerUrl: DEFAULT_WESTEND_INDEXER,
+    genesisHash: "0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e",
+    ss58Prefix: 42,
+    // Generic Substrate
+    isTestnet: true
+  }
+};
+
+// src/tokens.ts
+var USDT_POLKADOT = {
+  assetId: 1984,
+  symbol: "USDT",
+  name: "Tether USD",
+  decimals: 6,
+  issuer: "Tether"
+};
+var USDT_KUSAMA = {
+  assetId: 1984,
+  symbol: "USDT",
+  name: "Tether USD",
+  decimals: 6,
+  issuer: "Tether"
+};
+var USDT_WESTEND = {
+  assetId: 1984,
+  symbol: "USDT",
+  name: "Test Tether USD",
+  decimals: 6
+};
+var TOKEN_REGISTRY = {
+  [POLKADOT_ASSET_HUB_CAIP2]: {
+    USDT: USDT_POLKADOT
+  },
+  [KUSAMA_ASSET_HUB_CAIP2]: {
+    USDT: USDT_KUSAMA
+  },
+  [WESTEND_ASSET_HUB_CAIP2]: {
+    USDT: USDT_WESTEND
+  }
+};
+var DEFAULT_TOKENS = {
+  [POLKADOT_ASSET_HUB_CAIP2]: USDT_POLKADOT,
+  [KUSAMA_ASSET_HUB_CAIP2]: USDT_KUSAMA,
+  [WESTEND_ASSET_HUB_CAIP2]: USDT_WESTEND
+};
+function getTokenConfig(network, symbol = "USDT") {
+  return TOKEN_REGISTRY[network]?.[symbol];
+}
+function getAssetId(network, symbol = "USDT") {
+  return getTokenConfig(network, symbol)?.assetId;
+}
+
+// src/utils.ts
+function isValidAddress(address) {
+  if (!address || typeof address !== "string") {
+    return false;
+  }
+  const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{45,50}$/;
+  return base58Regex.test(address);
+}
+
+// src/exact-direct/client/scheme.ts
+var ExactDirectPolkadotClient = class {
+  scheme = SCHEME_EXACT_DIRECT;
+  signer;
+  constructor(config) {
+    this.signer = config.signer;
+  }
+  /**
+   * Create a payment payload by executing the transfer
+   */
+  async createPaymentPayload(t402Version, requirements) {
+    this.validateRequirements(requirements);
+    const { network, amount, payTo, extra } = requirements;
+    const symbol = extra?.assetSymbol || "USDT";
+    const assetId = extra?.assetId ?? getAssetId(network, symbol);
+    if (assetId === void 0) {
+      throw new Error(`Unknown asset ${symbol} on network ${network}`);
+    }
+    const from = await this.signer.getAddress();
+    const { extrinsicHash, blockHash, extrinsicIndex } = await this.signer.transferAsset(assetId, payTo, amount);
+    const polkadotPayload = {
+      extrinsicHash,
+      blockHash,
+      extrinsicIndex,
+      from,
+      to: payTo,
+      amount,
+      assetId
+    };
+    return {
+      t402Version,
+      payload: polkadotPayload
+    };
+  }
+  /**
+   * Validate payment requirements
+   */
+  validateRequirements(requirements) {
+    if (requirements.scheme !== SCHEME_EXACT_DIRECT) {
+      throw new Error(
+        `Invalid scheme: expected ${SCHEME_EXACT_DIRECT}, got ${requirements.scheme}`
+      );
+    }
+    if (!requirements.network.startsWith(`${POLKADOT_CAIP2_NAMESPACE}:`)) {
+      throw new Error(`Invalid network: ${requirements.network}`);
+    }
+    if (!isValidAddress(requirements.payTo)) {
+      throw new Error(`Invalid payTo address: ${requirements.payTo}`);
+    }
+    const amount = BigInt(requirements.amount);
+    if (amount <= 0n) {
+      throw new Error(`Invalid amount: ${requirements.amount}`);
+    }
+  }
+};
+function createExactDirectPolkadotClient(config) {
+  return new ExactDirectPolkadotClient(config);
+}
+export {
+  ExactDirectPolkadotClient,
+  createExactDirectPolkadotClient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/exact-direct/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/constants.ts","../../../src/tokens.ts","../../../src/utils.ts","../../../src/exact-direct/client/scheme.ts"],"sourcesContent":["/**\n * Polkadot Asset Hub T402 Constants\n *\n * Polkadot Asset Hub (formerly Statemint) is a common-good parachain\n * that hosts assets like USDT on the Polkadot network.\n */\n\n// CAIP-2 namespace for Polkadot\nexport const POLKADOT_CAIP2_NAMESPACE = \"polkadot\";\n\n// CAIP-2 network identifiers (first 32 chars of genesis hash)\n// Polkadot Asset Hub (Parachain ID: 1000)\nexport const POLKADOT_ASSET_HUB_CAIP2 = \"polkadot:68d56f15f85d3136970ec16946040bc1\";\n\n// Kusama Asset Hub (Parachain ID: 1000 on Kusama)\nexport const KUSAMA_ASSET_HUB_CAIP2 = \"polkadot:48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\";\n\n// Westend Asset Hub (Testnet)\nexport const WESTEND_ASSET_HUB_CAIP2 = \"polkadot:e143f23803ac50e8f6f8e62695d1ce9e\";\n\n// Scheme identifier\nexport const SCHEME_EXACT_DIRECT = \"exact-direct\";\n\n// Default indexers (Subscan API)\nexport const DEFAULT_POLKADOT_INDEXER = \"https://assethub-polkadot.api.subscan.io\";\nexport const DEFAULT_KUSAMA_INDEXER = \"https://assethub-kusama.api.subscan.io\";\nexport const DEFAULT_WESTEND_INDEXER = \"https://assethub-westend.api.subscan.io\";\n\n// Default RPC endpoints\nexport const DEFAULT_POLKADOT_RPC = \"wss://polkadot-asset-hub-rpc.polkadot.io\";\nexport const DEFAULT_KUSAMA_RPC = \"wss://kusama-asset-hub-rpc.polkadot.io\";\nexport const DEFAULT_WESTEND_RPC = \"wss://westend-asset-hub-rpc.polkadot.io\";\n\n// Network configurations\nexport interface PolkadotNetworkConfig {\n  readonly name: string;\n  readonly caip2: string;\n  readonly rpcUrl: string;\n  readonly indexerUrl: string;\n  readonly genesisHash: string;\n  readonly ss58Prefix: number;\n  readonly isTestnet: boolean;\n}\n\nexport const POLKADOT_NETWORKS: Record<string, PolkadotNetworkConfig> = {\n  [POLKADOT_ASSET_HUB_CAIP2]: {\n    name: \"Polkadot Asset Hub\",\n    caip2: POLKADOT_ASSET_HUB_CAIP2,\n    rpcUrl: DEFAULT_POLKADOT_RPC,\n    indexerUrl: DEFAULT_POLKADOT_INDEXER,\n    genesisHash: \"0x68d56f15f85d3136970ec16946040bc1752654e906147f7e43e9d539d7c3de2f\",\n    ss58Prefix: 0, // Polkadot\n    isTestnet: false,\n  },\n  [KUSAMA_ASSET_HUB_CAIP2]: {\n    name: \"Kusama Asset Hub\",\n    caip2: KUSAMA_ASSET_HUB_CAIP2,\n    rpcUrl: DEFAULT_KUSAMA_RPC,\n    indexerUrl: DEFAULT_KUSAMA_INDEXER,\n    genesisHash: \"0x48239ef607d7928874027a43a67689209727dfb3d3dc5e5b03a39bdc2eda771a\",\n    ss58Prefix: 2, // Kusama\n    isTestnet: false,\n  },\n  [WESTEND_ASSET_HUB_CAIP2]: {\n    name: \"Westend Asset Hub\",\n    caip2: WESTEND_ASSET_HUB_CAIP2,\n    rpcUrl: DEFAULT_WESTEND_RPC,\n    indexerUrl: DEFAULT_WESTEND_INDEXER,\n    genesisHash: \"0xe143f23803ac50e8f6f8e62695d1ce9e4e1d68aa36c1cd2cfd15340213f3423e\",\n    ss58Prefix: 42, // Generic Substrate\n    isTestnet: true,\n  },\n};\n\n/**\n * Get network configuration by CAIP-2 identifier\n */\nexport function getNetworkConfig(network: string): PolkadotNetworkConfig | undefined {\n  return POLKADOT_NETWORKS[network];\n}\n\n/**\n * Check if a network identifier is a Polkadot network\n */\nexport function isPolkadotNetwork(network: string): boolean {\n  return network.startsWith(`${POLKADOT_CAIP2_NAMESPACE}:`);\n}\n","/**\n * Polkadot Asset Hub Token Registry\n *\n * On Polkadot Asset Hub, tokens are identified by Asset IDs.\n * USDT is Asset ID 1984, created by Tether.\n */\n\nimport {\n  POLKADOT_ASSET_HUB_CAIP2,\n  KUSAMA_ASSET_HUB_CAIP2,\n  WESTEND_ASSET_HUB_CAIP2,\n} from \"./constants.js\";\n\n/**\n * Token configuration for Polkadot Asset Hub\n */\nexport interface TokenConfig {\n  /** Asset ID on Asset Hub */\n  readonly assetId: number;\n  /** Token symbol */\n  readonly symbol: string;\n  /** Token name */\n  readonly name: string;\n  /** Decimal places */\n  readonly decimals: number;\n  /** Issuer (creator of the asset) */\n  readonly issuer?: string;\n}\n\n/**\n * USDT on Polkadot Asset Hub\n * Asset ID: 1984\n * Decimals: 6\n */\nexport const USDT_POLKADOT: TokenConfig = {\n  assetId: 1984,\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: 6,\n  issuer: \"Tether\",\n};\n\n/**\n * USDT on Kusama Asset Hub\n * Asset ID: 1984 (same as Polkadot)\n */\nexport const USDT_KUSAMA: TokenConfig = {\n  assetId: 1984,\n  symbol: \"USDT\",\n  name: \"Tether USD\",\n  decimals: 6,\n  issuer: \"Tether\",\n};\n\n/**\n * Test USDT on Westend Asset Hub (testnet)\n */\nexport const USDT_WESTEND: TokenConfig = {\n  assetId: 1984,\n  symbol: \"USDT\",\n  name: \"Test Tether USD\",\n  decimals: 6,\n};\n\n/**\n * Network-specific token registries\n */\nexport const TOKEN_REGISTRY: Record<string, Record<string, TokenConfig>> = {\n  [POLKADOT_ASSET_HUB_CAIP2]: {\n    USDT: USDT_POLKADOT,\n  },\n  [KUSAMA_ASSET_HUB_CAIP2]: {\n    USDT: USDT_KUSAMA,\n  },\n  [WESTEND_ASSET_HUB_CAIP2]: {\n    USDT: USDT_WESTEND,\n  },\n};\n\n/**\n * Default tokens per network\n */\nexport const DEFAULT_TOKENS: Record<string, TokenConfig> = {\n  [POLKADOT_ASSET_HUB_CAIP2]: USDT_POLKADOT,\n  [KUSAMA_ASSET_HUB_CAIP2]: USDT_KUSAMA,\n  [WESTEND_ASSET_HUB_CAIP2]: USDT_WESTEND,\n};\n\n/**\n * Get token configuration by network and symbol\n */\nexport function getTokenConfig(\n  network: string,\n  symbol: string = \"USDT\",\n): TokenConfig | undefined {\n  return TOKEN_REGISTRY[network]?.[symbol];\n}\n\n/**\n * Get the default token for a network\n */\nexport function getDefaultToken(network: string): TokenConfig | undefined {\n  return DEFAULT_TOKENS[network];\n}\n\n/**\n * Get asset ID for a token on a network\n */\nexport function getAssetId(network: string, symbol: string = \"USDT\"): number | undefined {\n  return getTokenConfig(network, symbol)?.assetId;\n}\n","/**\n * Polkadot Asset Hub Utility Functions\n */\n\nimport type { PolkadotExtrinsicResult, ParsedAssetTransfer } from \"./types.js\";\n\n/**\n * Validate a Polkadot SS58 address format\n * SS58 addresses are base58-encoded with a checksum\n */\nexport function isValidAddress(address: string): boolean {\n  if (!address || typeof address !== \"string\") {\n    return false;\n  }\n\n  // SS58 addresses typically start with 1 (Polkadot), or have other prefixes\n  // Length is typically 47-48 characters for Polkadot addresses\n  // For a simple validation, check base58 characters and length\n  const base58Regex = /^[1-9A-HJ-NP-Za-km-z]{45,50}$/;\n  return base58Regex.test(address);\n}\n\n/**\n * Validate an extrinsic hash format\n * Extrinsic hashes are 32-byte hex strings prefixed with 0x\n */\nexport function isValidExtrinsicHash(hash: string): boolean {\n  if (!hash || typeof hash !== \"string\") {\n    return false;\n  }\n  return /^0x[a-fA-F0-9]{64}$/.test(hash);\n}\n\n/**\n * Validate a block hash format\n */\nexport function isValidBlockHash(hash: string): boolean {\n  return isValidExtrinsicHash(hash); // Same format\n}\n\n/**\n * Compare two SS58 addresses (case-sensitive)\n */\nexport function compareAddresses(addr1: string, addr2: string): boolean {\n  return addr1 === addr2;\n}\n\n/**\n * Format an amount with decimals for display\n */\nexport function formatAmount(amount: string, decimals: number): string {\n  const amountBigInt = BigInt(amount);\n  const divisor = BigInt(10 ** decimals);\n  const wholePart = amountBigInt / divisor;\n  const fractionalPart = amountBigInt % divisor;\n\n  if (fractionalPart === 0n) {\n    return wholePart.toString();\n  }\n\n  const fractionalStr = fractionalPart.toString().padStart(decimals, \"0\");\n  const trimmedFractional = fractionalStr.replace(/0+$/, \"\");\n  return `${wholePart}.${trimmedFractional}`;\n}\n\n/**\n * Parse an amount string to the smallest unit (with decimals applied)\n */\nexport function parseAmount(amount: string, decimals: number): string {\n  const parts = amount.split(\".\");\n  const wholePart = parts[0] || \"0\";\n  const fractionalPart = (parts[1] || \"\").padEnd(decimals, \"0\").slice(0, decimals);\n  return BigInt(wholePart + fractionalPart).toString();\n}\n\n/**\n * Extract asset transfer details from an extrinsic result\n */\nexport function extractAssetTransfer(\n  result: PolkadotExtrinsicResult,\n): ParsedAssetTransfer | null {\n  if (!result.success) {\n    return null;\n  }\n\n  // Check if this is an assets.transfer or assets.transferKeepAlive call\n  if (result.module !== \"assets\") {\n    return null;\n  }\n\n  if (result.call !== \"transfer\" && result.call !== \"transferKeepAlive\") {\n    return null;\n  }\n\n  // Extract transfer details from args\n  const assetId = result.args.id as number | undefined;\n  const to = result.args.target as string | undefined;\n  const amount = result.args.amount as string | undefined;\n\n  if (assetId === undefined || !to || !amount) {\n    return null;\n  }\n\n  return {\n    assetId,\n    from: result.signer,\n    to,\n    amount: amount.toString(),\n    success: true,\n  };\n}\n\n/**\n * Extract asset transfer from events (alternative method)\n */\nexport function extractAssetTransferFromEvents(\n  result: PolkadotExtrinsicResult,\n): ParsedAssetTransfer | null {\n  if (!result.success) {\n    return null;\n  }\n\n  // Look for assets.Transferred event\n  const transferEvent = result.events.find(\n    (e) => e.module === \"assets\" && e.name === \"Transferred\",\n  );\n\n  if (!transferEvent) {\n    return null;\n  }\n\n  const assetId = transferEvent.data.assetId as number | undefined;\n  const from = transferEvent.data.from as string | undefined;\n  const to = transferEvent.data.to as string | undefined;\n  const amount = transferEvent.data.amount as string | undefined;\n\n  if (assetId === undefined || !from || !to || !amount) {\n    return null;\n  }\n\n  return {\n    assetId,\n    from,\n    to,\n    amount: amount.toString(),\n    success: true,\n  };\n}\n\n/**\n * Build a unique extrinsic identifier from block hash and index\n */\nexport function buildExtrinsicId(blockHash: string, extrinsicIndex: number): string {\n  return `${blockHash}-${extrinsicIndex}`;\n}\n\n/**\n * Parse an extrinsic identifier back to components\n */\nexport function parseExtrinsicId(\n  extrinsicId: string,\n): { blockHash: string; extrinsicIndex: number } | null {\n  const lastDashIndex = extrinsicId.lastIndexOf(\"-\");\n  if (lastDashIndex === -1) {\n    return null;\n  }\n\n  const blockHash = extrinsicId.slice(0, lastDashIndex);\n  const extrinsicIndex = parseInt(extrinsicId.slice(lastDashIndex + 1), 10);\n\n  if (!isValidBlockHash(blockHash) || isNaN(extrinsicIndex)) {\n    return null;\n  }\n\n  return { blockHash, extrinsicIndex };\n}\n","/**\n * Polkadot Exact-Direct Client Scheme\n *\n * In the exact-direct scheme, the client executes the asset transfer directly\n * and provides the extrinsic hash as proof of payment.\n */\n\nimport type {\n  PaymentPayload,\n  PaymentRequirements,\n  SchemeNetworkClient,\n} from \"@t402/core/types\";\nimport type { ClientPolkadotSigner, ExactDirectPolkadotPayload } from \"../../types.js\";\nimport { SCHEME_EXACT_DIRECT, POLKADOT_CAIP2_NAMESPACE } from \"../../constants.js\";\nimport { getAssetId } from \"../../tokens.js\";\nimport { isValidAddress } from \"../../utils.js\";\n\n/**\n * Configuration for the exact-direct client\n */\nexport interface ExactDirectPolkadotClientConfig {\n  /** Signer for executing transactions */\n  signer: ClientPolkadotSigner;\n}\n\n/**\n * Exact-direct client scheme for Polkadot Asset Hub\n */\nexport class ExactDirectPolkadotClient implements SchemeNetworkClient {\n  readonly scheme = SCHEME_EXACT_DIRECT;\n  private readonly signer: ClientPolkadotSigner;\n\n  constructor(config: ExactDirectPolkadotClientConfig) {\n    this.signer = config.signer;\n  }\n\n  /**\n   * Create a payment payload by executing the transfer\n   */\n  async createPaymentPayload(\n    t402Version: number,\n    requirements: PaymentRequirements,\n  ): Promise<Pick<PaymentPayload, \"t402Version\" | \"payload\">> {\n    // Validate requirements\n    this.validateRequirements(requirements);\n\n    const { network, amount, payTo, extra } = requirements;\n\n    // Get asset ID from extra or use default USDT\n    const symbol = (extra?.assetSymbol as string) || \"USDT\";\n    const assetId = (extra?.assetId as number) ?? getAssetId(network, symbol);\n\n    if (assetId === undefined) {\n      throw new Error(`Unknown asset ${symbol} on network ${network}`);\n    }\n\n    // Get sender address\n    const from = await this.signer.getAddress();\n\n    // Execute the transfer\n    const { extrinsicHash, blockHash, extrinsicIndex } =\n      await this.signer.transferAsset(assetId, payTo, amount);\n\n    // Build the payload\n    const polkadotPayload: ExactDirectPolkadotPayload = {\n      extrinsicHash,\n      blockHash,\n      extrinsicIndex,\n      from,\n      to: payTo,\n      amount,\n      assetId,\n    };\n\n    return {\n      t402Version,\n      payload: polkadotPayload,\n    };\n  }\n\n  /**\n   * Validate payment requirements\n   */\n  private validateRequirements(requirements: PaymentRequirements): void {\n    // Check scheme\n    if (requirements.scheme !== SCHEME_EXACT_DIRECT) {\n      throw new Error(\n        `Invalid scheme: expected ${SCHEME_EXACT_DIRECT}, got ${requirements.scheme}`,\n      );\n    }\n\n    // Check network\n    if (!requirements.network.startsWith(`${POLKADOT_CAIP2_NAMESPACE}:`)) {\n      throw new Error(`Invalid network: ${requirements.network}`);\n    }\n\n    // Check payTo address\n    if (!isValidAddress(requirements.payTo)) {\n      throw new Error(`Invalid payTo address: ${requirements.payTo}`);\n    }\n\n    // Check amount\n    const amount = BigInt(requirements.amount);\n    if (amount <= 0n) {\n      throw new Error(`Invalid amount: ${requirements.amount}`);\n    }\n  }\n}\n\n/**\n * Create an exact-direct client for Polkadot\n */\nexport function createExactDirectPolkadotClient(\n  config: ExactDirectPolkadotClientConfig,\n): ExactDirectPolkadotClient {\n  return new ExactDirectPolkadotClient(config);\n}\n"],"mappings":"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","names":[]}