@waffo/waffo-node 2.5.0 → 2.6.0

package/README.md

@@ -1,6 +1,6 @@
 # Waffo Node.js SDK
 
-<!-- Synced with waffo-sdk/README.md @ commit d483eba -->
+<!-- Synced with waffo-sdk/README.md @ commit 738f4ca -->
 
 **English** | [中文](README_CN.md)
 
@@ -10,6 +10,12 @@
 
 Official Node.js/TypeScript SDK for [Waffo Payment Platform](https://www.waffo.com), providing one-stop global payment solutions for AI products, SaaS services, and more.
 
+## Latest Release Highlights
+
+- **Subscription update API**: Added `subscription().update()` with `amount`, `trialPeriodAmount`, and `scheduledAmounts` support.
+- **Scheduled amount coverage**: Added `scheduledAmounts` fields across subscription create, change, update, and inquiry product info types.
+- **E2E and contract hardening**: Added subscription update E2E coverage, auto-injected `captureRequestedAt` for `order.capture()`, and expanded nested schema field validation.
+
 ## Introduction
 
 ### Core Features
@@ -30,6 +36,7 @@ Official Node.js/TypeScript SDK for [Waffo Payment Platform](https://www.waffo.c
 
 ## Table of Contents
 
+- [Latest Release Highlights](#latest-release-highlights)
 - [Requirements](#requirements)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
@@ -671,6 +678,37 @@ if (response.isSuccess()) {
 }
 ```
 
+### Wallet Address Inquiry (x402)
+
+Inquire the on-chain stablecoin receiving address for an x402 payment. The response returns the target network, the on-chain token contract, and the Waffo platform wallet address to send funds to. Phase 1 supports `USDC`.
+
+```typescript
+// paymentRequestId: unique idempotency key for this inquiry
+// orderCurrency: settlement currency of the order (Phase 1 supports USDC)
+// merchantInfo is auto-injected from config if not provided
+const response = await waffo.wallet().inquiry({
+  paymentRequestId: 'unique-request-id',
+  orderCurrency: 'USDC',
+});
+
+if (response.isSuccess()) {
+  const data = response.getData();
+  console.log('Network:', data?.network); // CAIP-2 network id, e.g. eip155:8453 (Base mainnet)
+  console.log('Asset:', data?.asset);     // on-chain token contract address
+  console.log('Pay to:', data?.payTo);    // Waffo platform receiving wallet address
+} else {
+  console.error('Wallet inquiry failed:', response.getCode(), response.getMessage());
+}
+```
+
+#### Wallet Inquiry Response Fields
+
+| Field | Description |
+|-------|-------------|
+| `network` | CAIP-2 network id (Phase 1: `eip155:8453`, Base mainnet) |
+| `asset` | On-chain token contract address for the network + currency |
+| `payTo` | Waffo platform receiving wallet address (send funds here) |
+
 ## Webhook Handling
 
 Waffo pushes payment results, refund results, subscription status changes, and more via webhooks.
@@ -855,6 +893,8 @@ The following examples show the actual payload structure for each notification t
 }
 ```
 
+For x402 stablecoin payments, `PAYMENT_NOTIFICATION.result` also includes `x402Info` with `x402Request`, `paymentSignatureHeader`, and `x402Response`.
+
 #### SUBSCRIPTION_STATUS_NOTIFICATION / SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION
 
 These two notification types share the same payload structure:
@@ -1421,4 +1461,3 @@ npm run test:vectors
 ## License
 
 MIT License - See [LICENSE](LICENSE) file for details.
-