@dcasegr/amm-client 0.42.2 → 0.42.3

package/README.md

@@ -75,7 +75,7 @@ The client (each an async function unless noted):
   `setTokenTerms` (0.40.0: the terms `{lpBps, validatorBps, commissionBps, minLegSats?}`), `discoveryState`, `setDiscovery`,
   `setEnablePrice`, `exchangeWallet`, `withdrawAll`, `settleWithdrawals` (0.42.x);
 - the paid enable (0.42.2, anyone signed; open-exchange 0.15.3): `enableTokenPaid(tokenId, {deployBeef?})` — the price
-  from `/amm/defaults`, a BRC-29 payment to the exchange built with `noSend` (not sent: the exchange's take-in sends it),
+  from `/amm/defaults`, a BRC-29 payment to the exchange built as a protected noSend (0.42.3: BRC-177, `p nosend expiry seconds 600`; not sent: the exchange's take-in sends it),
   ONE BEEF with the deploy and the payment, `POST /amm/enable?tokenId=&paymentTxid=&paymentVout=&derivationPrefix=
   &derivationSuffix=` signed; the enabled row back; on any refusal or failure the unsent payment is aborted
   (`abortAction`). Refusals are `ClientError` kind `refused`, the exchange's code first in the message.

package/dist/client.d.ts

@@ -391,6 +391,8 @@ export interface EnableCandidate {
     onDiscovery: boolean;
     inWallet: boolean;
 }
+/** 0.42.3: the paid enable's payment is a protected noSend (BRC-177): the wallet reclaims it if nobody sends it within 600 s. */
+export declare const ENABLE_PAYMENT_EXPIRY_LABEL = "p nosend expiry seconds 600";
 /**
  * The candidates to enable: discovery's token list (its order, newest first, with its metadata),
  * then the tokens only this wallet holds (in the order held); every token already on the swap

package/dist/client.js

@@ -212,6 +212,8 @@ export async function walletDeployBeef(wallet, tokenId) {
     }
     return undefined;
 }
+/** 0.42.3: the paid enable's payment is a protected noSend (BRC-177): the wallet reclaims it if nobody sends it within 600 s. */
+export const ENABLE_PAYMENT_EXPIRY_LABEL = "p nosend expiry seconds 600";
 const canonicalId = (tokenId) => {
     const ref = parseTokenId(tokenId);
     return ref ? tokenIdText(ref) : null;
@@ -1311,7 +1313,10 @@ function makeClient(opts, s) {
      * (`GET <origin>/@discovery/1color/<token>/deploy`). The payment, ts-stack's standard (sdk BasicBRC29): a prefix and
      * a suffix from `createNonce`, the payee key `getPublicKey({protocolID: [2, "3241645161d8"], keyID: "<prefix>
      * <suffix>", counterparty: <the exchange>})`, ONE P2PKH output of exactly the price, `createAction` with
-     * `{randomizeOutputs: false, noSend: true}` — built and signed, NOT sent: the exchange's take-in sends it. Then ONE
+     * `{noSend: true, randomizeOutputs: false}` and the BRC-177 label `ENABLE_PAYMENT_EXPIRY_LABEL` (0.42.3: a protected
+     * noSend — the wallet prefunds an exact anchor and stores the payment, no change; a plain noSend lived only in the
+     * toolbox's client-side batch, so the payer's storage never learned of it) — built and signed, NOT sent: the
+     * exchange's take-in sends it; a wallet whose storage has no BRC-177 fails the createAction (surfaced). Then ONE
      * BEEF merging the deploy's and the payment's, `POST <swap>/enable?tokenId=&paymentTxid=&paymentVout=0
      * &derivationPrefix=&derivationSuffix=` signed (BRC-104). On any refusal or failure after the payment was built, the
      * unsent payment is aborted in the wallet (`abortAction`), so its coins are free again. → the enabled row.
@@ -1341,7 +1346,14 @@ function makeClient(opts, s) {
         const created = await wallet.createAction({
             description: "Open Exchange: enable a token",
             outputs: [{ satoshis: price, lockingScript: p2pkhHexOf(publicKey), outputDescription: "Open Exchange enable fee", customInstructions: JSON.stringify({ derivationPrefix, derivationSuffix, payee: exchange }) }],
-            options: { randomizeOutputs: false, noSend: true },
+            // 0.42.3: a protected noSend (BRC-177, as @1sat/actions' payment to a handle): the wallet prefunds an exact anchor,
+            // stores the payment in its storage with no change, and reclaims it if nobody sends it in time.
+            labels: [ENABLE_PAYMENT_EXPIRY_LABEL],
+            options: { noSend: true, randomizeOutputs: false },
+        }).catch((e) => {
+            // No fallback to a plain noSend: a wallet that cannot make a protected one (BRC-177) says why.
+            const c = toClientError(e);
+            throw c instanceof ClientError ? c : new ClientError("refused", `the wallet could not build the protected payment (BRC-177 noSend): ${errText(e)}`, { cause: e });
         });
         const txid = created.txid;
         if (!txid || !created.tx)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dcasegr/amm-client",
-  "version": "0.42.2",
+  "version": "0.42.3",
   "type": "module",
   "description": "The Open Exchange client (skein-amm): reads, swap, pool deploy / close / rebalance, move back and positions over a BRC-100 wallet, bound to one exchange by createClient. No React, no styles, no wallet provider.",
   "repository": {
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@1sat/actions": "0.1.3",
-    "@dcasegr/amm-engine": "0.42.2",
+    "@dcasegr/amm-engine": "0.42.3",
     "cbor2": "^2.3.0"
   },
   "peerDependencies": {