@warda_protocol/vendor 0.1.0 → 0.2.0

package/dist/node.d.ts

@@ -26,9 +26,20 @@ export interface NodeSource {
     resolver?: string;
     /** Which chain, as kaspad names it: `mainnet`, `testnet-10`. */
     network: string;
+    /**
+     * Whether to fall back to a node this vendor does not control.
+     *
+     * `auto` (the default) tries a resolver, then borsh if it is installed.
+     * `none` refuses, and the refusal is a legitimate position rather than a
+     * test seam: the doc above names the trade honestly — a dishonest node
+     * could report a payment that does not exist, and the loss is the
+     * SELLER's — so a seller who would rather answer 503 than hand goods over
+     * on a stranger's word should be able to say so.
+     */
+    fallback?: "auto" | "none";
 }
 export interface OpenedNode {
-    client: NodeClient;
+    client: Pick<NodeClient, "getUtxosByAddresses" | "close">;
     /** Sentence for the receipt: which node's word this is. */
     readFrom: string;
 }

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAA6B,MAAM,uBAAuB,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CA8CtE"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAA6B,MAAM,uBAAuB,CAAC;AAE9E,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IAGzB,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC;IAC1D,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAsEtE"}

package/dist/node.js

@@ -32,7 +32,8 @@ export async function openNode(source) {
             firstFailure = e.message;
         }
     }
-    const resolver = source.resolver ?? resolverFrom({});
+    const allowFallback = (source.fallback ?? "auto") === "auto";
+    const resolver = allowFallback ? source.resolver ?? resolverFrom({}) : null;
     if (resolver) {
         /**
          * `resolveNode` then `open`, not `open` alone.
@@ -57,8 +58,43 @@ export async function openNode(source) {
                 `answering whether you paid it.`,
         };
     }
-    throw new Error(firstFailure
-        ? `${firstFailure}\n\nNo resolver was configured, so there was nothing to fall back to.`
-        : "no rpc url and no resolver: this vendor cannot read the chain");
+    /**
+     * Borsh, last, and only if it is installed.
+     *
+     * Optional rather than a dependency: it pulls a wasm binary, and a vendor
+     * running its own JSON node should not have to download one to decline it.
+     * The import is lazy for the same reason.
+     */
+    const borsh = allowFallback ? await loadBorsh() : null;
+    if (borsh) {
+        const client = await borsh.BorshReader.open({ networkId: source.network });
+        return {
+            client,
+            readFrom: `a public node found by a resolver, over borsh, because this vendor's own node ` +
+                `could not be reached. A node this vendor does not control is answering whether ` +
+                `you paid it.`,
+        };
+    }
+    throw new Error((firstFailure ? `${firstFailure}\n\n` : "") +
+        `This vendor has no node it can read.\n\n` +
+        `  A seller never submits a transaction — it only asks whether a coin is at its own\n` +
+        `  address — so it does not need a JSON node. Installing @warda_protocol/borsh lets\n` +
+        `  this fall back to the public resolvers, which serve borsh and not JSON.\n\n` +
+        `    npm install @warda_protocol/borsh kaspa-wasm32-sdk`);
+}
+/**
+ * `@warda_protocol/borsh` if it is there, and nothing if it is not.
+ *
+ * A missing optional dependency is a configuration fact, not an error: the
+ * caller gets a message naming the install, rather than a module-resolution
+ * stack trace from inside a payment.
+ */
+async function loadBorsh() {
+    try {
+        return (await import("@warda_protocol/borsh"));
+    }
+    catch {
+        return null;
+    }
 }
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAiB9E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAkB;IAC/C,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;gBACrD,QAAQ,EAAE,wBAAwB;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,YAAY,GAAI,CAAW,CAAC,OAAO,CAAC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC;IACrD,IAAI,QAAQ,EAAE,CAAC;QACb;;;;;;;;;;WAUG;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;YAC/C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,SAAS,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,OAAO;YACL,MAAM;YACN,QAAQ,EACN,6CAA6C,MAAM,CAAC,aAAa,kBAAkB;gBACnF,iFAAiF;gBACjF,gCAAgC;SACnC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CACb,YAAY;QACV,CAAC,CAAC,GAAG,YAAY,uEAAuE;QACxF,CAAC,CAAC,+DAA+D,CACpE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA8B9E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAkB;IAC/C,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,IAAI,CAAC;YACH,OAAO;gBACL,MAAM,EAAE,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;gBACrD,QAAQ,EAAE,wBAAwB;aACnC,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,YAAY,GAAI,CAAW,CAAC,OAAO,CAAC;QACtC,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,KAAK,MAAM,CAAC;IAE7D,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,IAAI,QAAQ,EAAE,CAAC;QACb;;;;;;;;;;WAUG;QACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACzE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC;YAC/C,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,SAAS,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,OAAO;YACL,MAAM;YACN,QAAQ,EACN,6CAA6C,MAAM,CAAC,aAAa,kBAAkB;gBACnF,iFAAiF;gBACjF,gCAAgC;SACnC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3E,OAAO;YACL,MAAM;YACN,QAAQ,EACN,gFAAgF;gBAChF,iFAAiF;gBACjF,cAAc;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CACb,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,0CAA0C;QAC1C,sFAAsF;QACtF,sFAAsF;QACtF,+EAA+E;QAC/E,wDAAwD,CAC3D,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,SAAS;IACtB,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAU,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warda_protocol/vendor",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Sell an API for Kaspa over HTTP 402. Quotes a price, then verifies the payment is in the UTXO set before serving \u2014 it never trusts the payment header.",
   "type": "module",
   "license": "MIT",
@@ -51,5 +51,13 @@
   "bugs": {
     "url": "https://github.com/ArtyKOMarkets/warda/issues"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "peerDependencies": {
+    "@warda_protocol/borsh": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@warda_protocol/borsh": {
+      "optional": true
+    }
+  }
 }