@hazbase/simplicity 0.4.0 → 0.4.1

package/README.md

@@ -152,6 +152,18 @@ Main entrypoints:
 Representative example:
 - [show-receivable-business-flow.ts](./examples/show-receivable-business-flow.ts)
 
+### RWA DvP and Liquid x402
+
+Use `sdk.rwaDvp` when a purchase flow needs a Liquid PSET payment request,
+delivery/refund claim descriptors, and an evidence bundle that ties the Liquid
+payment and delivery to an external lock or allocation record.
+
+For standard Liquid assets, `payment.asset` can be `"lbtc"` or `"usdt"`. If a
+testnet issuer or deployment uses a different USDt asset id, set
+`payment.asset: "usdt"` and pass the explicit `payment.assetId`; the generated
+payment requirements will preserve that asset id instead of replacing it with
+the SDK's default registry id.
+
 ## CLI and Confidence Commands
 
 ### Validation Surface

package/dist/domain/rwaDvp.js

@@ -77,6 +77,7 @@ function buildPaymentRequirements(_sdk, input) {
         amountAtomic: input.purchase.payment.amountAtomic,
         network: input.purchase.network,
         asset: input.purchase.payment.asset,
+        assetId: input.purchase.payment.assetId,
         description: input.description ?? "Hazbase RWA Liquid delivery-versus-payment",
         mimeType: input.mimeType ?? "application/json",
         maxTimeoutSeconds: input.maxTimeoutSeconds,

package/dist/x402/index.d.ts

@@ -20,6 +20,7 @@ export interface LiquidX402RequirementsInput {
     amountAtomic: string | number | bigint;
     network?: LiquidX402Network;
     asset?: LiquidX402AssetKey | string;
+    assetId?: string;
     description?: string;
     mimeType?: string;
     maxTimeoutSeconds?: number;

package/dist/x402/index.js

@@ -77,6 +77,7 @@ function resolveLiquidX402Asset(asset, network = exports.LIQUID_X402_DEFAULT_NET
 function buildLiquidX402Requirements(input) {
     const network = normalizeNetwork(input.network ?? exports.LIQUID_X402_DEFAULT_NETWORK);
     const asset = resolveLiquidX402Asset(input.asset ?? "usdt", network);
+    const assetId = resolveLiquidX402AssetId(input.assetId, asset);
     const amountAtomic = normalizeAmountAtomic(input.amountAtomic);
     const expiresAt = normalizeExpiresAt(input.expiresAt, input.maxTimeoutSeconds);
     const description = String(input.description ?? "").trim() || "Unlock resource";
@@ -100,11 +101,11 @@ function buildLiquidX402Requirements(input) {
         mimeType,
         payTo,
         maxTimeoutSeconds,
-        asset: asset.assetId,
+        asset: assetId,
         extra: {
             paymentRequestId,
             asset: asset.key,
-            assetId: asset.assetId,
+            assetId,
             decimals: asset.decimals,
             expiresAt,
             feeAsset: "lbtc",
@@ -585,6 +586,12 @@ function isLiquidAssetAlias(input) {
         value === "usdt-liquid" ||
         value === "tether";
 }
+function resolveLiquidX402AssetId(input, asset) {
+    const value = String(input ?? "").trim();
+    if (!value)
+        return asset.assetId;
+    return isLiquidAssetAlias(value) ? asset.assetId : value;
+}
 function normalizeAmountAtomic(input) {
     const raw = typeof input === "bigint" ? input.toString() : String(input ?? "").trim();
     if (!/^\d+$/u.test(raw))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazbase/simplicity",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "An SDK for Simplicity on Liquid",
   "author": "IndieSquare Inc <info@hazbase.com>",
   "keywords": [