uvd-x402-sdk 2.108.0 → 2.109.0

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

@@ -19,7 +19,7 @@ interface PaymentIdParams extends EscrowMsgParams {
 }
 interface NearLocalSigner {
     readonly publicKey: Uint8Array;
-    /** Sign the NEP-366 SHA-256 digest directly, without a NEP-413 envelope. */
+    /** Sign the supplied SHA-256 digest directly. The calling helper supplies its domain prefix. */
     sign(digest: Uint8Array): Uint8Array | Promise<Uint8Array>;
 }
 interface NearEscrowDelegateOptions {
@@ -95,6 +95,154 @@ declare const withdrawFor: (o: NearEscrowDelegateOptions, account: string) => Pr
 interface AuthorizeFromBudget {
     authorizeFromBudget(request: unknown): Promise<NearEscrowPayment>;
 }
+/** Local-key exact NEP-366 payment; uses the escrow serializer and raw digest signer. */
+interface NearExactDelegateOptions extends Omit<NearEscrowDelegateOptions, 'escrowContract'> {
+    token: string;
+    payTo: string;
+    amount: NearUnsigned;
+}
+interface NearExactPayment extends Omit<NearEscrowPayment, 'scheme'> {
+    scheme: 'exact';
+}
+declare function signExactNearDelegate(options: NearExactDelegateOptions): Promise<NearExactPayment>;
+
+interface Nep413Message {
+    message: string;
+    nonce: Uint8Array;
+    recipient: string;
+    callbackUrl?: string;
+}
+interface SignNep413Options extends Nep413Message {
+    signer: NearLocalSigner;
+    accountId: string;
+}
+interface Nep413SignedMessage {
+    accountId: string;
+    publicKey: string;
+    signature: string;
+}
+/** Prefix 2^31+413 followed by message, fixed nonce, recipient and Option<String> callback. */
+declare function nep413Preimage(options: Nep413Message): Uint8Array;
+declare function signNep413(options: SignNep413Options): Promise<Nep413SignedMessage>;
+
+/** Payer-funded NEP-145 calls. These are unsigned normal transactions, never facilitator delegates. */
+
+interface NearStorageTransaction {
+    signerId: string;
+    receiverId: string;
+    actions: [
+        {
+            type: 'FunctionCall';
+            params: {
+                methodName: 'storage_deposit';
+                args: {
+                    account_id: string;
+                    registration_only: boolean;
+                };
+                gas: string;
+                deposit: string;
+            };
+        }
+    ];
+}
+interface NearStorageOptions {
+    network: NearEscrowNetwork;
+    /** Account that signs the normal transaction and pays its deposit and gas. */
+    payerId: string;
+    /** Account to register or fund; defaults to payerId. */
+    accountId?: string;
+    /** YoctoNEAR, not NEAR. Query storage_balance_bounds for the live contract minimum. */
+    deposit?: NearUnsigned;
+}
+/** Explicit trusted deployment configuration; this unsigned builder does not select an account parent. */
+interface ArrasStorageOptions extends NearStorageOptions {
+    escrowContract: string;
+}
+declare const NEAR_ARRAS_STORAGE_DEPOSIT = "50000000000000000000000";
+declare const NEAR_USDC_STORAGE_DEPOSIT = "1250000000000000000000";
+/** Keep surplus available for payment storage; registration_only must be false for Arras. */
+declare function buildArrasStorageDeposit(options: ArrasStorageOptions): NearStorageTransaction;
+/** Register in native USDC; refund any surplus rather than topping up an FT registration. */
+declare function buildUsdcStorageDeposit(options: NearStorageOptions): NearStorageTransaction;
+
+interface ArrasAuthorizedData {
+    payment_id: string;
+    operator_id: string;
+    token: string;
+    payer: string;
+    receiver: string;
+    amount: string;
+    fee_bps: number;
+    fee_recipient: string;
+    terms_hash: string;
+}
+interface ArrasReleasedData {
+    payment_id: string;
+    amount: string;
+    net: string;
+    fee: string;
+}
+interface ArrasPaymentAmountData {
+    payment_id: string;
+    amount: string;
+}
+interface ArrasWithdrawnData {
+    account: string;
+    token: string;
+    amount: string;
+    ok: boolean;
+}
+interface ArrasCompactedData {
+    payment_id: string;
+}
+interface ArrasOperatorData {
+    operator_id: string;
+    owner?: string;
+    capturers?: string[];
+    fee_bps?: number;
+    fee_recipient?: string;
+    min_amount?: string;
+    tope_tvl_operador?: string;
+    tope_tvl_por_payer?: string;
+    sponsor_max_por_payer?: string;
+}
+interface ArrasCapsSetData {
+    by: string;
+    tope_por_pago: string;
+    tope_tvl_global: string;
+}
+interface ArrasPauseData {
+    by: string;
+    paused: boolean;
+    at: string;
+}
+interface ArrasEventData {
+    authorized: ArrasAuthorizedData;
+    released: ArrasReleasedData;
+    refunded: ArrasPaymentAmountData;
+    reclaimed: ArrasPaymentAmountData;
+    withdrawn: ArrasWithdrawnData;
+    compacted: ArrasCompactedData;
+    operator_registered: ArrasOperatorData;
+    operator_updated: ArrasOperatorData;
+    caps_set: ArrasCapsSetData;
+    paused: ArrasPauseData;
+    unpaused: ArrasPauseData;
+}
+type ArrasEvent = {
+    [K in keyof ArrasEventData]: {
+        standard: 'arras';
+        version: '1.0.0';
+        event: K;
+        data: ArrasEventData[K][];
+    };
+}[keyof ArrasEventData];
+/**
+ * Pass flattened receipt outcome logs. Foreign logs, malformed envelopes/data and unknown
+ * standards, versions or events are skipped. Preserve each batch and decimal integer bytes.
+ * Logs alone do not authenticate the emitter: the caller must check the receipt executor/status.
+ */
+declare function parseArrasEvents(logs: readonly unknown[]): ArrasEvent[];
 
 /**
  * uvd-x402-sdk - NEAR Provider
@@ -234,4 +382,4 @@ declare class NEARProvider implements WalletAdapter {
     private base58Encode;
 }
 
-export { type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, NEARProvider, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearLocalSigner, type NearUnsigned, type PaymentIdParams, type WalletSelectorOptions, buildEscrowAuthorizationDelegate, buildEscrowMsg, computePaymentId, createNearLocalSigner, NEARProvider as default, paymentIdPreimage, reclaim, refund, release, signEscrowAuthorization, signEscrowLifecycle, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };
+export { type ArrasAuthorizedData, type ArrasCapsSetData, type ArrasCompactedData, type ArrasEvent, type ArrasEventData, type ArrasOperatorData, type ArrasPauseData, type ArrasPaymentAmountData, type ArrasReleasedData, type ArrasStorageOptions, type ArrasWithdrawnData, type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, NEARProvider, NEAR_ARRAS_STORAGE_DEPOSIT, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, NEAR_USDC_STORAGE_DEPOSIT, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearExactDelegateOptions, type NearExactPayment, type NearLocalSigner, type NearStorageOptions, type NearStorageTransaction, type NearUnsigned, type Nep413Message, type Nep413SignedMessage, type PaymentIdParams, type SignNep413Options, type WalletSelectorOptions, buildArrasStorageDeposit, buildEscrowAuthorizationDelegate, buildEscrowMsg, buildUsdcStorageDeposit, computePaymentId, createNearLocalSigner, NEARProvider as default, nep413Preimage, parseArrasEvents, paymentIdPreimage, reclaim, refund, release, signEscrowAuthorization, signEscrowLifecycle, signExactNearDelegate, signNep413, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };

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

@@ -19,7 +19,7 @@ interface PaymentIdParams extends EscrowMsgParams {
 }
 interface NearLocalSigner {
     readonly publicKey: Uint8Array;
-    /** Sign the NEP-366 SHA-256 digest directly, without a NEP-413 envelope. */
+    /** Sign the supplied SHA-256 digest directly. The calling helper supplies its domain prefix. */
     sign(digest: Uint8Array): Uint8Array | Promise<Uint8Array>;
 }
 interface NearEscrowDelegateOptions {
@@ -95,6 +95,154 @@ declare const withdrawFor: (o: NearEscrowDelegateOptions, account: string) => Pr
 interface AuthorizeFromBudget {
     authorizeFromBudget(request: unknown): Promise<NearEscrowPayment>;
 }
+/** Local-key exact NEP-366 payment; uses the escrow serializer and raw digest signer. */
+interface NearExactDelegateOptions extends Omit<NearEscrowDelegateOptions, 'escrowContract'> {
+    token: string;
+    payTo: string;
+    amount: NearUnsigned;
+}
+interface NearExactPayment extends Omit<NearEscrowPayment, 'scheme'> {
+    scheme: 'exact';
+}
+declare function signExactNearDelegate(options: NearExactDelegateOptions): Promise<NearExactPayment>;
+
+interface Nep413Message {
+    message: string;
+    nonce: Uint8Array;
+    recipient: string;
+    callbackUrl?: string;
+}
+interface SignNep413Options extends Nep413Message {
+    signer: NearLocalSigner;
+    accountId: string;
+}
+interface Nep413SignedMessage {
+    accountId: string;
+    publicKey: string;
+    signature: string;
+}
+/** Prefix 2^31+413 followed by message, fixed nonce, recipient and Option<String> callback. */
+declare function nep413Preimage(options: Nep413Message): Uint8Array;
+declare function signNep413(options: SignNep413Options): Promise<Nep413SignedMessage>;
+
+/** Payer-funded NEP-145 calls. These are unsigned normal transactions, never facilitator delegates. */
+
+interface NearStorageTransaction {
+    signerId: string;
+    receiverId: string;
+    actions: [
+        {
+            type: 'FunctionCall';
+            params: {
+                methodName: 'storage_deposit';
+                args: {
+                    account_id: string;
+                    registration_only: boolean;
+                };
+                gas: string;
+                deposit: string;
+            };
+        }
+    ];
+}
+interface NearStorageOptions {
+    network: NearEscrowNetwork;
+    /** Account that signs the normal transaction and pays its deposit and gas. */
+    payerId: string;
+    /** Account to register or fund; defaults to payerId. */
+    accountId?: string;
+    /** YoctoNEAR, not NEAR. Query storage_balance_bounds for the live contract minimum. */
+    deposit?: NearUnsigned;
+}
+/** Explicit trusted deployment configuration; this unsigned builder does not select an account parent. */
+interface ArrasStorageOptions extends NearStorageOptions {
+    escrowContract: string;
+}
+declare const NEAR_ARRAS_STORAGE_DEPOSIT = "50000000000000000000000";
+declare const NEAR_USDC_STORAGE_DEPOSIT = "1250000000000000000000";
+/** Keep surplus available for payment storage; registration_only must be false for Arras. */
+declare function buildArrasStorageDeposit(options: ArrasStorageOptions): NearStorageTransaction;
+/** Register in native USDC; refund any surplus rather than topping up an FT registration. */
+declare function buildUsdcStorageDeposit(options: NearStorageOptions): NearStorageTransaction;
+
+interface ArrasAuthorizedData {
+    payment_id: string;
+    operator_id: string;
+    token: string;
+    payer: string;
+    receiver: string;
+    amount: string;
+    fee_bps: number;
+    fee_recipient: string;
+    terms_hash: string;
+}
+interface ArrasReleasedData {
+    payment_id: string;
+    amount: string;
+    net: string;
+    fee: string;
+}
+interface ArrasPaymentAmountData {
+    payment_id: string;
+    amount: string;
+}
+interface ArrasWithdrawnData {
+    account: string;
+    token: string;
+    amount: string;
+    ok: boolean;
+}
+interface ArrasCompactedData {
+    payment_id: string;
+}
+interface ArrasOperatorData {
+    operator_id: string;
+    owner?: string;
+    capturers?: string[];
+    fee_bps?: number;
+    fee_recipient?: string;
+    min_amount?: string;
+    tope_tvl_operador?: string;
+    tope_tvl_por_payer?: string;
+    sponsor_max_por_payer?: string;
+}
+interface ArrasCapsSetData {
+    by: string;
+    tope_por_pago: string;
+    tope_tvl_global: string;
+}
+interface ArrasPauseData {
+    by: string;
+    paused: boolean;
+    at: string;
+}
+interface ArrasEventData {
+    authorized: ArrasAuthorizedData;
+    released: ArrasReleasedData;
+    refunded: ArrasPaymentAmountData;
+    reclaimed: ArrasPaymentAmountData;
+    withdrawn: ArrasWithdrawnData;
+    compacted: ArrasCompactedData;
+    operator_registered: ArrasOperatorData;
+    operator_updated: ArrasOperatorData;
+    caps_set: ArrasCapsSetData;
+    paused: ArrasPauseData;
+    unpaused: ArrasPauseData;
+}
+type ArrasEvent = {
+    [K in keyof ArrasEventData]: {
+        standard: 'arras';
+        version: '1.0.0';
+        event: K;
+        data: ArrasEventData[K][];
+    };
+}[keyof ArrasEventData];
+/**
+ * Pass flattened receipt outcome logs. Foreign logs, malformed envelopes/data and unknown
+ * standards, versions or events are skipped. Preserve each batch and decimal integer bytes.
+ * Logs alone do not authenticate the emitter: the caller must check the receipt executor/status.
+ */
+declare function parseArrasEvents(logs: readonly unknown[]): ArrasEvent[];
 
 /**
  * uvd-x402-sdk - NEAR Provider
@@ -234,4 +382,4 @@ declare class NEARProvider implements WalletAdapter {
     private base58Encode;
 }
 
-export { type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, NEARProvider, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearLocalSigner, type NearUnsigned, type PaymentIdParams, type WalletSelectorOptions, buildEscrowAuthorizationDelegate, buildEscrowMsg, computePaymentId, createNearLocalSigner, NEARProvider as default, paymentIdPreimage, reclaim, refund, release, signEscrowAuthorization, signEscrowLifecycle, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };
+export { type ArrasAuthorizedData, type ArrasCapsSetData, type ArrasCompactedData, type ArrasEvent, type ArrasEventData, type ArrasOperatorData, type ArrasPauseData, type ArrasPaymentAmountData, type ArrasReleasedData, type ArrasStorageOptions, type ArrasWithdrawnData, type AuthorizeFromBudget, type EscrowAuthorizationOptions, type EscrowMsgParams, NEARProvider, NEAR_ARRAS_STORAGE_DEPOSIT, NEAR_ESCROW_CONTRACTS, NEAR_ESCROW_MAX_GAS, NEAR_ESCROW_MIN_GAS, NEAR_ESCROW_TOKENS, NEAR_USDC_STORAGE_DEPOSIT, type NearEscrowDelegate, type NearEscrowDelegateOptions, type NearEscrowFunctionCall, type NearEscrowLifecycleMethod, type NearEscrowNetwork, type NearEscrowPayment, type NearExactDelegateOptions, type NearExactPayment, type NearLocalSigner, type NearStorageOptions, type NearStorageTransaction, type NearUnsigned, type Nep413Message, type Nep413SignedMessage, type PaymentIdParams, type SignNep413Options, type WalletSelectorOptions, buildArrasStorageDeposit, buildEscrowAuthorizationDelegate, buildEscrowMsg, buildUsdcStorageDeposit, computePaymentId, createNearLocalSigner, NEARProvider as default, nep413Preimage, parseArrasEvents, paymentIdPreimage, reclaim, refund, release, signEscrowAuthorization, signEscrowLifecycle, signExactNearDelegate, signNep413, validateEscrowAuthorizationDelegate, withdraw, withdrawFor };

package/dist/providers/near/index.js

@@ -1300,17 +1300,8 @@ function chainToCAIP2(chainName) {
   }
   return chainName;
 }
-var NEAR_ESCROW_MIN_GAS = 38000000000000n;
-var NEAR_ESCROW_MAX_GAS = 100000000000000n;
-var NEAR_ESCROW_TOKENS = Object.freeze({
-  "near:mainnet": "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
-  "near:testnet": "3e2210e1184b45b64c8a434c0a7e7b23cc04ea7eb7a6c3c32520d03d4afcb8af"
-});
-var NEAR_ESCROW_CONTRACTS = Object.freeze({
-  "near:testnet": Object.freeze(["arras-v1b-1101.testnet"]),
-  "near:mainnet": Object.freeze([])
-});
-var NONCE_RANGE_MULTIPLIER = 1000000n;
+
+// src/providers/near/encoding.ts
 function fullMatch(pattern, value) {
   return pattern.exec(value)?.[0] === value;
 }
@@ -1325,12 +1316,6 @@ function uint(value, bits, name) {
 function account(value, name) {
   if (typeof value !== "string" || value.length < 2 || value.length > 64 || !fullMatch(/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/, value)) throw new Error(`${name}: invalid NEAR account`);
 }
-function hex(value, size, name) {
-  if (typeof value !== "string" || value.length !== size * 2 || !fullMatch(/^[0-9a-f]+$/, value)) {
-    throw new Error(`${name}: expected ${size} bytes of lowercase hex without 0x`);
-  }
-  return Uint8Array.from(value.match(/../g), (v) => parseInt(v, 16));
-}
 function concat(...parts) {
   const out = new Uint8Array(parts.reduce((sum, p) => sum + p.length, 0));
   let at = 0;
@@ -1344,6 +1329,10 @@ function le(n, size) {
   return Uint8Array.from({ length: size }, (_, i) => Number(n >> BigInt(i * 8) & 255n));
 }
 function str(s) {
+  for (const c of s) {
+    const point = c.codePointAt(0);
+    if (point >= 55296 && point <= 57343) throw new Error("Expected valid Unicode scalar values");
+  }
   const bytes = new TextEncoder().encode(s);
   return concat(le(BigInt(bytes.length), 4), bytes);
 }
@@ -1364,6 +1353,25 @@ function unbase58(value) {
   const zeros = value.match(/^1*/u)[0].length;
   return concat(new Uint8Array(zeros), Uint8Array.from(bytes.reverse()));
 }
+
+// src/providers/near/escrow.ts
+var NEAR_ESCROW_MIN_GAS = 38000000000000n;
+var NEAR_ESCROW_MAX_GAS = 100000000000000n;
+var NEAR_ESCROW_TOKENS = Object.freeze({
+  "near:mainnet": "17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1",
+  "near:testnet": "3e2210e1184b45b64c8a434c0a7e7b23cc04ea7eb7a6c3c32520d03d4afcb8af"
+});
+var NEAR_ESCROW_CONTRACTS = Object.freeze({
+  "near:testnet": Object.freeze(["arras-v1b-1101.testnet"]),
+  "near:mainnet": Object.freeze([])
+});
+var NONCE_RANGE_MULTIPLIER = 1000000n;
+function hex(value, size, name) {
+  if (typeof value !== "string" || value.length !== size * 2 || !fullMatch(/^[0-9a-f]+$/, value)) {
+    throw new Error(`${name}: expected ${size} bytes of lowercase hex without 0x`);
+  }
+  return Uint8Array.from(value.match(/../g), (v) => parseInt(v, 16));
+}
 function msgValues(p) {
   if (typeof p.operator_id !== "string" || !fullMatch(/^[a-z0-9_-]{1,32}$/, p.operator_id)) {
     throw new Error("operator_id: expected [a-z0-9_-]{1,32}");
@@ -1373,8 +1381,8 @@ function msgValues(p) {
   const reclaim2 = uint(p.reclaim_after, 64, "reclaim_after");
   if (release2 >= reclaim2) throw new Error("release_deadline must precede reclaim_after");
   if (typeof p.fee_bps_max !== "number") throw new Error("fee_bps_max: expected a number");
-  const fee = uint(p.fee_bps_max, 16, "fee_bps_max");
-  return { release: release2, reclaim: reclaim2, fee, terms: hex(p.terms_hash, 32, "terms_hash"), salt: hex(p.salt, 16, "salt") };
+  const fee2 = uint(p.fee_bps_max, 16, "fee_bps_max");
+  return { release: release2, reclaim: reclaim2, fee: fee2, terms: hex(p.terms_hash, 32, "terms_hash"), salt: hex(p.salt, 16, "salt") };
 }
 function buildEscrowMsg(p) {
   const v = msgValues(p);
@@ -1436,6 +1444,9 @@ function delegateOptions(o) {
   if (!NEAR_ESCROW_CONTRACTS[o.network].includes(o.escrowContract)) {
     throw new Error(`escrowContract: not a registered Arras escrow for ${o.network}`);
   }
+  delegateNonce(o);
+}
+function delegateNonce(o) {
   const nonce = uint(o.nonce, 64, "nonce");
   if (nonce === 0n) throw new Error("nonce must be positive");
   const height = uint(o.maxBlockHeight, 64, "maxBlockHeight");
@@ -1472,7 +1483,7 @@ function validateEscrowAuthorizationDelegate(d, o) {
   const gas = uint(a.gas, 64, "gas");
   if (gas < NEAR_ESCROW_MIN_GAS || gas > NEAR_ESCROW_MAX_GAS) throw new Error("FT gas outside 38..100 TGas");
 }
-async function signDelegate(o, d) {
+async function signDelegate(o, d, scheme = "escrow") {
   const network = o.network;
   const pk = new Uint8Array(o.signer.publicKey);
   if (pk.length !== 32) throw new Error("Expected 32-byte Ed25519 public key");
@@ -1499,7 +1510,7 @@ async function signDelegate(o, d) {
   const signed = concat(bytes, Uint8Array.of(0), signature);
   return {
     x402Version: 2,
-    scheme: "escrow",
+    scheme,
     network,
     payload: { signedDelegateAction: btoa(Array.from(signed, (b) => String.fromCharCode(b)).join("")) }
   };
@@ -1551,6 +1562,167 @@ var refund = (o, paymentId) => signEscrowLifecycle(o, "refund", { payment_id: pa
 var reclaim = (o, paymentId) => signEscrowLifecycle(o, "reclaim", { payment_id: paymentId });
 var withdraw = (o) => signEscrowLifecycle(o, "withdraw");
 var withdrawFor = (o, account2) => signEscrowLifecycle(o, "withdraw_for", { account: account2 });
+async function signExactNearDelegate(options) {
+  const o = { ...options };
+  if (o.network !== "near:mainnet" && o.network !== "near:testnet") throw new Error("Unsupported NEAR network");
+  account(o.senderId, "senderId");
+  account(o.payTo, "payTo");
+  if (o.payTo === "intents.near") throw new Error("intents.near is not an allowed recipient");
+  if (o.token !== NEAR_ESCROW_TOKENS[o.network]) throw new Error("token does not match network USDC");
+  delegateNonce(o);
+  const amount = uint(o.amount, 128, "amount");
+  if (amount === 0n) throw new Error("amount must be positive");
+  const gas = uint(o.gas ?? 30000000000000n, 64, "gas");
+  if (gas === 0n || gas > 30000000000000n) throw new Error("Exact gas must be positive and at most 30 TGas");
+  return signDelegate(o, {
+    senderId: o.senderId,
+    receiverId: o.token,
+    nonce: o.nonce,
+    maxBlockHeight: o.maxBlockHeight,
+    actions: [{
+      methodName: "ft_transfer",
+      args: JSON.stringify({ receiver_id: o.payTo, amount: amount.toString() }),
+      gas,
+      deposit: 1n
+    }]
+  }, "exact");
+}
+function nep413Preimage(options) {
+  const { message, recipient, callbackUrl, nonce } = options;
+  if (typeof message !== "string") throw new Error("message must be a string");
+  if (typeof recipient !== "string" || recipient.length === 0 || recipient.trim() !== recipient) {
+    throw new Error("recipient must be a nonempty string without surrounding whitespace");
+  }
+  if (recipient.toLowerCase().replace(/\.$/u, "") === "intents.near") throw new Error("intents.near is not an allowed recipient");
+  if (!(nonce instanceof Uint8Array) || nonce.length !== 32) throw new Error("nonce must contain 32 bytes");
+  if (callbackUrl !== void 0 && typeof callbackUrl !== "string") throw new Error("callbackUrl must be a string");
+  return concat(
+    le(2147484061n, 4),
+    str(message),
+    new Uint8Array(nonce),
+    str(recipient),
+    callbackUrl === void 0 ? Uint8Array.of(0) : concat(Uint8Array.of(1), str(callbackUrl))
+  );
+}
+async function signNep413(options) {
+  const o = { ...options };
+  account(o.accountId, "accountId");
+  const digest = sha256.sha256(nep413Preimage(o));
+  const pk = new Uint8Array(o.signer.publicKey);
+  if (pk.length !== 32) throw new Error("Expected 32-byte Ed25519 public key");
+  const signature = await o.signer.sign(digest.slice());
+  if (!(signature instanceof Uint8Array) || signature.length !== 64 || !ed25519.ed25519.verify(signature, digest, pk)) {
+    throw new Error("Invalid Ed25519 NEP-413 signature");
+  }
+  return {
+    accountId: o.accountId,
+    publicKey: `ed25519:${ethers.encodeBase58(pk)}`,
+    signature: btoa(Array.from(signature, (b) => String.fromCharCode(b)).join(""))
+  };
+}
+
+// src/providers/near/storage.ts
+var NEAR_ARRAS_STORAGE_DEPOSIT = "50000000000000000000000";
+var NEAR_USDC_STORAGE_DEPOSIT = "1250000000000000000000";
+function storage(o, receiverId, registrationOnly, defaultDeposit) {
+  if (o.network !== "near:mainnet" && o.network !== "near:testnet") throw new Error("Unsupported NEAR network");
+  account(receiverId, "receiverId");
+  if (receiverId === "intents.near") throw new Error("intents.near is not an allowed storage target");
+  account(o.payerId, "payerId");
+  const accountId = o.accountId ?? o.payerId;
+  account(accountId, "accountId");
+  const deposit = uint(o.deposit ?? defaultDeposit, 128, "deposit");
+  if (deposit === 0n) throw new Error("storage deposit must be positive");
+  return { signerId: o.payerId, receiverId, actions: [{ type: "FunctionCall", params: {
+    methodName: "storage_deposit",
+    args: { account_id: accountId, registration_only: registrationOnly },
+    gas: "30000000000000",
+    deposit: deposit.toString()
+  } }] };
+}
+function buildArrasStorageDeposit(options) {
+  const o = { ...options };
+  if (o.network !== "near:mainnet" && o.network !== "near:testnet") throw new Error("Unsupported NEAR network");
+  return storage(o, o.escrowContract, false, NEAR_ARRAS_STORAGE_DEPOSIT);
+}
+function buildUsdcStorageDeposit(options) {
+  const o = { ...options };
+  return storage(o, NEAR_ESCROW_TOKENS[o.network], true, NEAR_USDC_STORAGE_DEPOSIT);
+}
+
+// src/providers/near/events.ts
+var string = (v) => typeof v === "string";
+var boolean = (v) => typeof v === "boolean";
+var integer = (bits) => (v) => {
+  if (typeof v !== "string") return false;
+  try {
+    uint(v, bits, "event integer");
+    return true;
+  } catch {
+    return false;
+  }
+};
+var u128 = integer(128);
+var u64 = integer(64);
+var fee = (v) => typeof v === "number" && Number.isInteger(v) && v >= 0 && v <= 65535;
+var strings = (v) => Array.isArray(v) && v.every(string);
+var object = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function record(required, optional = {}) {
+  return (v) => object(v) && Object.entries(required).every(([k, check]) => Object.hasOwn(v, k) && check(v[k])) && Object.entries(optional).every(([k, check]) => !Object.hasOwn(v, k) || check(v[k]));
+}
+var operator = record({ operator_id: string }, {
+  owner: string,
+  capturers: strings,
+  fee_bps: fee,
+  fee_recipient: string,
+  min_amount: u128,
+  tope_tvl_operador: u128,
+  tope_tvl_por_payer: u128,
+  sponsor_max_por_payer: u128
+});
+var paymentAmount = record({ payment_id: string, amount: u128 });
+var pause = record({ by: string, paused: boolean, at: u64 });
+var checks = {
+  authorized: record({
+    payment_id: string,
+    operator_id: string,
+    token: string,
+    payer: string,
+    receiver: string,
+    amount: u128,
+    fee_bps: fee,
+    fee_recipient: string,
+    terms_hash: string
+  }),
+  released: record({ payment_id: string, amount: u128, net: u128, fee: u128 }),
+  refunded: paymentAmount,
+  reclaimed: paymentAmount,
+  withdrawn: record({ account: string, token: string, amount: u128, ok: boolean }),
+  compacted: record({ payment_id: string }),
+  operator_registered: operator,
+  operator_updated: operator,
+  caps_set: record({ by: string, tope_por_pago: u128, tope_tvl_global: u128 }),
+  paused: pause,
+  unpaused: pause
+};
+function parseArrasEvents(logs) {
+  const result = [];
+  if (!Array.isArray(logs)) return result;
+  for (const log of logs) {
+    if (typeof log !== "string" || !log.startsWith("EVENT_JSON:")) continue;
+    let value;
+    try {
+      value = JSON.parse(log.slice(11));
+    } catch {
+      continue;
+    }
+    if (!object(value) || value.standard !== "arras" || value.version !== "1.0.0" || typeof value.event !== "string" || !Object.hasOwn(checks, value.event) || !Array.isArray(value.data)) continue;
+    const check = checks[value.event];
+    if (!value.data.every(check)) continue;
+    result.push({ standard: "arras", version: "1.0.0", event: value.event, data: value.data });
+  }
+  return result;
+}
 
 // src/providers/near/index.ts
 var NEAR_CONFIG = {
@@ -1631,7 +1803,7 @@ function serializeSignedDelegateAction(delegateActionBytes, signatureBytes) {
   ser.writeFixedBytes(signatureBytes);
   return ser.getBytes();
 }
-async function sha2562(data) {
+async function sha2563(data) {
   const hashBuffer = await crypto.subtle.digest("SHA-256", data);
   return new Uint8Array(hashBuffer);
 }
@@ -1875,7 +2047,7 @@ var NEARProvider = class {
       const hashInput = new Uint8Array(NEP366_PREFIX.length + delegateActionBytes.length);
       hashInput.set(NEP366_PREFIX, 0);
       hashInput.set(delegateActionBytes, NEP366_PREFIX.length);
-      const delegateHash = await sha2562(hashInput);
+      const delegateHash = await sha2563(hashInput);
       const signature = await this.signMessage(delegateHash);
       const signedDelegateActionBytes = serializeSignedDelegateAction(
         delegateActionBytes,
@@ -2084,21 +2256,29 @@ var NEARProvider = class {
 var near_default = NEARProvider;
 
 exports.NEARProvider = NEARProvider;
+exports.NEAR_ARRAS_STORAGE_DEPOSIT = NEAR_ARRAS_STORAGE_DEPOSIT;
 exports.NEAR_ESCROW_CONTRACTS = NEAR_ESCROW_CONTRACTS;
 exports.NEAR_ESCROW_MAX_GAS = NEAR_ESCROW_MAX_GAS;
 exports.NEAR_ESCROW_MIN_GAS = NEAR_ESCROW_MIN_GAS;
 exports.NEAR_ESCROW_TOKENS = NEAR_ESCROW_TOKENS;
+exports.NEAR_USDC_STORAGE_DEPOSIT = NEAR_USDC_STORAGE_DEPOSIT;
+exports.buildArrasStorageDeposit = buildArrasStorageDeposit;
 exports.buildEscrowAuthorizationDelegate = buildEscrowAuthorizationDelegate;
 exports.buildEscrowMsg = buildEscrowMsg;
+exports.buildUsdcStorageDeposit = buildUsdcStorageDeposit;
 exports.computePaymentId = computePaymentId;
 exports.createNearLocalSigner = createNearLocalSigner;
 exports.default = near_default;
+exports.nep413Preimage = nep413Preimage;
+exports.parseArrasEvents = parseArrasEvents;
 exports.paymentIdPreimage = paymentIdPreimage;
 exports.reclaim = reclaim;
 exports.refund = refund;
 exports.release = release;
 exports.signEscrowAuthorization = signEscrowAuthorization;
 exports.signEscrowLifecycle = signEscrowLifecycle;
+exports.signExactNearDelegate = signExactNearDelegate;
+exports.signNep413 = signNep413;
 exports.validateEscrowAuthorizationDelegate = validateEscrowAuthorizationDelegate;
 exports.withdraw = withdraw;
 exports.withdrawFor = withdrawFor;