@t402/near 2.3.0

package/dist/esm/index.mjs

@@ -0,0 +1,97 @@
+import {
+  ExactDirectNearClient,
+  registerExactDirectNearClient
+} from "./chunk-YXBOH4MJ.mjs";
+import {
+  ExactDirectNearServer,
+  registerExactDirectNearServer
+} from "./chunk-B3RHERRA.mjs";
+import {
+  ExactDirectNearFacilitator,
+  registerExactDirectNearFacilitator
+} from "./chunk-BU2BQECZ.mjs";
+import {
+  TOKEN_REGISTRY,
+  getDefaultToken,
+  getNetworkTokens,
+  getTokenByContract,
+  getTokenConfig,
+  isNetworkSupported
+} from "./chunk-G35SAYZI.mjs";
+import {
+  DEFAULT_FT_TRANSFER_GAS,
+  DEFAULT_STORAGE_DEPOSIT,
+  DEFAULT_STORAGE_DEPOSIT_GAS,
+  DEFAULT_VALIDITY_DURATION,
+  FT_TRANSFER_DEPOSIT,
+  MAX_TRANSACTION_AGE,
+  NEAR_CAIP2_NAMESPACE,
+  NEAR_MAINNET_CAIP2,
+  NEAR_MAINNET_RPC,
+  NEAR_NETWORKS,
+  NEAR_NETWORK_IDS,
+  NEAR_TESTNET_CAIP2,
+  NEAR_TESTNET_RPC,
+  NEP141_FT_BALANCE_OF,
+  NEP141_FT_TRANSFER,
+  NEP141_STORAGE_BALANCE_OF,
+  NEP141_STORAGE_DEPOSIT,
+  NETWORK_RPC_ENDPOINTS,
+  SCHEME_EXACT_DIRECT,
+  extractNetworkId,
+  formatAmount,
+  getRpcEndpoint,
+  isTransactionSuccessful,
+  isValidAccountId,
+  normalizeNetwork,
+  parseFtTransferArgs,
+  queryTokenBalance,
+  queryTransaction,
+  rpcCall,
+  toTokenUnits
+} from "./chunk-WANNPL6S.mjs";
+export {
+  DEFAULT_FT_TRANSFER_GAS,
+  DEFAULT_STORAGE_DEPOSIT,
+  DEFAULT_STORAGE_DEPOSIT_GAS,
+  DEFAULT_VALIDITY_DURATION,
+  ExactDirectNearClient,
+  ExactDirectNearFacilitator,
+  ExactDirectNearServer,
+  FT_TRANSFER_DEPOSIT,
+  MAX_TRANSACTION_AGE,
+  NEAR_CAIP2_NAMESPACE,
+  NEAR_MAINNET_CAIP2,
+  NEAR_MAINNET_RPC,
+  NEAR_NETWORKS,
+  NEAR_NETWORK_IDS,
+  NEAR_TESTNET_CAIP2,
+  NEAR_TESTNET_RPC,
+  NEP141_FT_BALANCE_OF,
+  NEP141_FT_TRANSFER,
+  NEP141_STORAGE_BALANCE_OF,
+  NEP141_STORAGE_DEPOSIT,
+  NETWORK_RPC_ENDPOINTS,
+  SCHEME_EXACT_DIRECT,
+  TOKEN_REGISTRY,
+  extractNetworkId,
+  formatAmount,
+  getDefaultToken,
+  getNetworkTokens,
+  getRpcEndpoint,
+  getTokenByContract,
+  getTokenConfig,
+  isNetworkSupported,
+  isTransactionSuccessful,
+  isValidAccountId,
+  normalizeNetwork,
+  parseFtTransferArgs,
+  queryTokenBalance,
+  queryTransaction,
+  registerExactDirectNearClient,
+  registerExactDirectNearFacilitator,
+  registerExactDirectNearServer,
+  rpcCall,
+  toTokenUnits
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types-Ca7ztL_f.d.mts

@@ -0,0 +1,169 @@
+/**
+ * NEAR Payment Types
+ *
+ * Defines the payload structure for NEAR NEP-141 payments using the exact-direct scheme.
+ * The exact-direct scheme has the client execute the transfer directly, then provide
+ * the transaction hash as proof of payment.
+ */
+/**
+ * NEAR payment payload for the exact-direct scheme
+ * Contains transaction hash and metadata for verification
+ */
+type ExactDirectNearPayload = {
+    /**
+     * Transaction hash of the completed ft_transfer
+     * This is the base58 encoded transaction hash from NEAR
+     */
+    txHash: string;
+    /**
+     * Sender account ID (e.g., "alice.near")
+     */
+    from: string;
+    /**
+     * Recipient account ID (e.g., "merchant.near")
+     */
+    to: string;
+    /**
+     * Transfer amount in smallest units (e.g., "1000000" for 1 USDC)
+     */
+    amount: string;
+};
+/**
+ * Result of transaction verification
+ */
+interface VerifyTransactionResult {
+    /** Whether the transaction is valid */
+    valid: boolean;
+    /** Reason for invalidity (if applicable) */
+    reason?: string;
+    /** Extracted transfer parameters */
+    transfer?: {
+        from: string;
+        to: string;
+        amount: bigint;
+        tokenContract: string;
+        blockHash: string;
+    };
+}
+/**
+ * NEAR transaction status
+ */
+interface TransactionStatus {
+    SuccessValue?: string;
+    Failure?: unknown;
+}
+/**
+ * NEAR transaction outcome
+ */
+interface TransactionOutcome {
+    block_hash: string;
+    id: string;
+}
+/**
+ * NEAR function call action
+ */
+interface FunctionCallAction {
+    FunctionCall: {
+        method_name: string;
+        args: string;
+        gas: number;
+        deposit: string;
+    };
+}
+/**
+ * NEAR transaction
+ */
+interface NearTransaction {
+    hash: string;
+    signer_id: string;
+    receiver_id: string;
+    actions: FunctionCallAction[];
+}
+/**
+ * NEAR transaction result from RPC query
+ */
+interface TransactionResult {
+    status: TransactionStatus;
+    transaction: NearTransaction;
+    transaction_outcome: TransactionOutcome;
+    receipts_outcome: Array<{
+        id: string;
+        outcome: {
+            status: TransactionStatus;
+            gas_burnt: number;
+            tokens_burnt: string;
+        };
+    }>;
+}
+/**
+ * NEAR RPC request
+ */
+interface NearRpcRequest {
+    jsonrpc: "2.0";
+    id: string;
+    method: string;
+    params: unknown[] | Record<string, unknown>;
+}
+/**
+ * NEAR RPC response
+ */
+interface NearRpcResponse<T = unknown> {
+    jsonrpc: "2.0";
+    id: string;
+    result?: T;
+    error?: {
+        code: number;
+        message: string;
+        data?: string;
+    };
+}
+/**
+ * ft_transfer arguments
+ */
+interface FtTransferArgs {
+    receiver_id: string;
+    amount: string;
+    memo?: string | null;
+}
+/**
+ * NEAR signer interface for client operations
+ */
+interface ClientNearSigner {
+    /** Get the account ID */
+    readonly accountId: string;
+    /**
+     * Sign and send a transaction
+     * @param receiverId - Contract to call
+     * @param methodName - Method to call
+     * @param args - Method arguments
+     * @param gas - Gas to attach
+     * @param deposit - yoctoNEAR to attach
+     * @returns Transaction hash
+     */
+    signAndSendTransaction(receiverId: string, methodName: string, args: Record<string, unknown>, gas: string, deposit: string): Promise<string>;
+}
+/**
+ * NEAR signer interface for facilitator operations
+ */
+interface FacilitatorNearSigner {
+    /**
+     * Get the facilitator's account IDs for a network
+     * @param network - CAIP-2 network identifier
+     */
+    getAddresses(network: string): string[];
+    /**
+     * Query a transaction by hash
+     * @param txHash - Transaction hash
+     * @param senderAccountId - Sender account ID (required for NEAR tx query)
+     * @returns Transaction result
+     */
+    queryTransaction(txHash: string, senderAccountId: string): Promise<TransactionResult>;
+    /**
+     * Get token balance for an account
+     * @param accountId - Account ID
+     * @param tokenContract - Token contract address
+     */
+    getBalance(accountId: string, tokenContract: string): Promise<bigint>;
+}
+
+export type { ClientNearSigner as C, ExactDirectNearPayload as E, FtTransferArgs as F, NearRpcRequest as N, TransactionResult as T, VerifyTransactionResult as V, TransactionStatus as a, TransactionOutcome as b, FunctionCallAction as c, NearTransaction as d, NearRpcResponse as e, FacilitatorNearSigner as f };

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@t402/near",
+  "version": "2.3.0",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "keywords": [
+    "t402",
+    "payment",
+    "protocol",
+    "near",
+    "blockchain",
+    "nep-141"
+  ],
+  "license": "Apache-2.0",
+  "author": "T402 Team",
+  "repository": "https://github.com/t402-io/t402",
+  "description": "t402 Payment Protocol NEAR Implementation",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/node": "^22.13.4",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "eslint": "^9.24.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-prettier": "^5.2.6",
+    "glob": "^13.0.0",
+    "prettier": "3.5.2",
+    "tsup": "^8.4.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.3",
+    "vite": "^7.3.1",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {
+    "@t402/core": "2.3.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./exact-direct/client": {
+      "import": {
+        "types": "./dist/esm/exact-direct/client/index.d.mts",
+        "default": "./dist/esm/exact-direct/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/client/index.d.ts",
+        "default": "./dist/cjs/exact-direct/client/index.js"
+      }
+    },
+    "./exact-direct/server": {
+      "import": {
+        "types": "./dist/esm/exact-direct/server/index.d.mts",
+        "default": "./dist/esm/exact-direct/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/server/index.d.ts",
+        "default": "./dist/cjs/exact-direct/server/index.js"
+      }
+    },
+    "./exact-direct/facilitator": {
+      "import": {
+        "types": "./dist/esm/exact-direct/facilitator/index.d.mts",
+        "default": "./dist/esm/exact-direct/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact-direct/facilitator/index.d.ts",
+        "default": "./dist/cjs/exact-direct/facilitator/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "tsx --env-file=.env index.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:watch": "vitest",
+    "watch": "tsc --watch",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "lint": "eslint . --ext .ts --fix",
+    "lint:check": "eslint . --ext .ts"
+  }
+}