@armory-sh/client-web3 0.2.23-alpha.23.77 → 0.2.23-alpha.23.79

package/README.md

@@ -8,6 +8,7 @@ Armory x402 SDK — Payment client for Web3.js. Make payments from any Web3.js w
 
 ```bash
 bun add @armory-sh/client-web3
+bun add @armory-sh/client-hooks # optional preference/logger hooks
 ```
 
 ## Why Armory?
@@ -60,6 +61,25 @@ const response = await client.fetch('https://api.example.com/protected')
 const data = await response.json()
 ```
 
+## Hook Pipeline
+
+```typescript
+import { createX402Client } from '@armory-sh/client-web3'
+import { PaymentPreference, Logger } from '@armory-sh/client-hooks'
+
+const client = createX402Client({
+  account,
+  hooks: [
+    PaymentPreference.chain(['base', 'polygon', 'skale']),
+    PaymentPreference.token(['USDT', 'USDC', 'WBTC']),
+    PaymentPreference.cheapest(),
+    Logger.console(),
+  ],
+})
+```
+
+`parsePaymentRequired` returns `accepts[]` (x402 v2 challenge options). Clients select from this list.
+
 ## Features
 
 - **Auto 402 Handling**: Automatically intercepts and pays for 402 responses

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { NetworkConfig, CustomToken, PaymentPayloadV2, PaymentRequirementsV2, SettlementResponseV2, NetworkId, TokenId, ArmoryPaymentResult, ValidationError } from '@armory-sh/base';
+import { ClientHook } from '@armory-sh/base/types/hooks';
 import { Web3BaseWalletAccount, Web3BaseWallet } from 'web3-types';
 
 type Web3Account = Web3BaseWalletAccount | Web3BaseWallet<Web3BaseWalletAccount>;
@@ -15,6 +16,7 @@ interface Web3ClientConfig {
     domainName?: string;
     /** Override EIP-712 domain version for custom tokens */
     domainVersion?: string;
+    hooks?: ClientHook<Web3Account>[];
 }
 interface PaymentSignatureResult {
     signature?: {

package/dist/index.js

@@ -1,4 +1,5 @@
 import { encodePaymentV2, validatePaymentConfig, isValidationError, resolveNetwork, resolveToken, V2_HEADERS, getNetworkConfig, getNetworkByChainId, networkToCaip2, combineSignatureV2, normalizeBase64Url, decodeBase64ToUtf8, isX402V2PaymentRequired } from '@armory-sh/base';
+import { runOnPaymentRequiredHooks, selectRequirementWithHooks, runBeforeSignPaymentHooks, runAfterPaymentResponseHooks } from '@armory-sh/base/client-hooks-runtime';
 import { Web3 } from 'web3';
 
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
@@ -300,6 +301,7 @@ var extractNetworkFromRequirements = (requirements) => {
 };
 var createX402Client = (config) => {
   const state = createClientState(config);
+  const hooks = config.hooks;
   const fetch2 = async (url, init) => {
     let response = await fetch2(url, init);
     if (response.status === 402) {
@@ -309,7 +311,22 @@ var createX402Client = (config) => {
         throw new Error("No supported payment scheme found in requirements");
       }
       const from = getAddress(state.account);
-      const req = selectedRequirements;
+      const paymentRequiredContext = {
+        url,
+        requestInit: init,
+        accepts: parsed.requirements,
+        requirements: selectedRequirements,
+        selectedRequirement: selectedRequirements,
+        serverExtensions: void 0,
+        fromAddress: from,
+        nonce: `0x${Date.now().toString(16).padStart(64, "0")}`,
+        validBefore: Math.floor(Date.now() / 1e3) + selectedRequirements.maxTimeoutSeconds
+      };
+      await runOnPaymentRequiredHooks(hooks, paymentRequiredContext);
+      const req = await selectRequirementWithHooks(
+        hooks,
+        paymentRequiredContext
+      );
       const to = typeof req.payTo === "string" ? req.payTo : "0x0000000000000000000000000000000000000000";
       const network = extractNetworkFromRequirements(req);
       const result = await signPaymentV2(state, network, {
@@ -320,12 +337,25 @@ var createX402Client = (config) => {
         expiry: Math.floor(Date.now() / 1e3) + req.maxTimeoutSeconds,
         accepted: req
       });
+      await runBeforeSignPaymentHooks(hooks, {
+        payload: result.payload,
+        requirements: req,
+        wallet: state.account,
+        paymentContext: paymentRequiredContext
+      });
       const paymentHeaders = new Headers(init?.headers);
       paymentHeaders.set(
         V2_HEADERS.PAYMENT_SIGNATURE,
         encodePaymentV2(result.payload)
       );
       response = await fetch2(url, { ...init, headers: paymentHeaders });
+      await runAfterPaymentResponseHooks(hooks, {
+        payload: result.payload,
+        requirements: req,
+        wallet: state.account,
+        paymentContext: paymentRequiredContext,
+        response
+      });
     }
     return response;
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@armory-sh/client-web3",
-  "version": "0.2.23-alpha.23.77",
+  "version": "0.2.23-alpha.23.79",
   "license": "MIT",
   "author": "Sawyer Cutler <sawyer@dirtroad.dev>",
   "keywords": [
@@ -46,7 +46,7 @@
     "directory": "packages/client-web3"
   },
   "dependencies": {
-    "@armory-sh/base": "0.2.27-alpha.23.77",
+    "@armory-sh/base": "0.2.27-alpha.23.79",
     "web3": "4.16.0",
     "web3-types": "1.10.0"
   },