@antseed/node 0.2.99 → 0.2.101

package/dist/types/protocol.d.ts

@@ -18,6 +18,8 @@ export declare enum MessageType {
     NeedFreeUsageAuth = 85,
     PaymentRequired = 86,
     NeedAuth = 88,
+    CloseChannelRequest = 89,
+    CloseChannelResult = 90,
     PeerReport = 96,
     ReportAck = 97,
     PeerRating = 112,
@@ -31,12 +33,20 @@ export declare enum MessageType {
 }
 export declare const CONNECTION_CAPABILITY_RESPONSE_AUTH_V1: "verification.response-auth.v1";
 export declare const CONNECTION_CAPABILITY_RELAYS_SWEEPS_V1: "payments.relays-sweeps.v1";
+/** Seller honours buyer-initiated cooperative channel close (0x59 / 0x5A). */
+export declare const CONNECTION_CAPABILITY_COOPERATIVE_CLOSE_V1: "payments.cooperative-close.v1";
 export declare function peerRelaysSweeps(peer: {
     capabilities?: string[];
     metadata?: {
         capabilities?: string[];
     };
 }): boolean;
+export declare function peerSupportsCooperativeClose(peer: {
+    capabilities?: string[];
+    metadata?: {
+        capabilities?: string[];
+    };
+}): boolean;
 export interface FramedMessage {
     type: MessageType;
     messageId: number;
@@ -177,6 +187,56 @@ export interface NeedAuthPayload {
     /** Service/model name for service-specific pricing validation. */
     service?: string;
 }
+/**
+ * Buyer asks the seller to close a payment channel now, skipping the on-chain
+ * `requestClose()` → 15-minute grace → `withdraw()` path.
+ *
+ * The buyer MAY attach its latest SpendingAuth so the seller can close at that
+ * cumulative even if the seller never received it (e.g. the frame was lost on
+ * disconnect). The seller closes at whichever cumulative is higher — its own
+ * last-accepted auth or the one attached here — so neither side can use this
+ * message to under-report spend.
+ *
+ * All four auth fields travel together: either all are present or none are.
+ */
+export interface CloseChannelRequestPayload {
+    version: 1;
+    /** Channel the buyer wants closed. Must match the seller's active channel. */
+    channelId: string;
+    /** Cumulative USDC (base units) the attached signature authorizes. */
+    cumulativeAmount?: string;
+    /** bytes32 keccak256 of `metadata`. */
+    metadataHash?: string;
+    /** Hex-encoded abi.encode(...) usage metadata covered by the signature. */
+    metadata?: string;
+    /** EIP-712 SpendingAuth signature over (channelId, cumulativeAmount, metadataHash). */
+    spendingAuthSig?: string;
+}
+/** Why a seller declined to close a channel on request. */
+export declare const CLOSE_CHANNEL_REJECT_CODES: readonly ["busy", "pending_auth", "no_channel", "invalid_auth", "close_failed", "unsupported"];
+export type CloseChannelRejectCode = typeof CLOSE_CHANNEL_REJECT_CODES[number];
+/**
+ * Seller's answer to a CloseChannelRequest. On success it carries the
+ * transaction hash of the on-chain `close()`; on refusal, a stable code the
+ * buyer can switch on.
+ */
+export interface CloseChannelResultPayload {
+    version: 1;
+    channelId: string;
+    status: 'closed' | 'rejected';
+    /** Present when status === 'closed'. */
+    txHash?: string;
+    /** Cumulative the channel was closed at (base units). Present on success. */
+    finalAmount?: string;
+    /** Present when status === 'rejected'. */
+    code?: CloseChannelRejectCode;
+    /** Human-readable detail. Never load-bearing — switch on `code`. */
+    reason?: string;
+    /** Hint for 'busy' / 'pending_auth': wait this long before retrying. */
+    retryAfterMs?: number;
+    /** For 'pending_auth': the cumulative the buyer must sign before retrying. */
+    requiredCumulativeAmount?: string;
+}
 /**
  * Buyer broadcasts a signed gasless deposit sweep for permissionless relayers
  * (sellers by default) to submit on-chain. Carries everything

package/dist/types/protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,aAAa,IAAO;IACpB,YAAY,IAAO;IACnB,IAAI,KAAO;IACX,IAAI,KAAO;IACX,WAAW,KAAO;IAClB,YAAY,KAAO;IACnB,iBAAiB,KAAO;IACxB,eAAe,KAAO;IACtB,iBAAiB,KAAO;IAExB,gBAAgB,KAAO;IACvB,cAAc,KAAS;IAGvB,YAAY,KAAO;IACnB,OAAO,KAAO;IACd,aAAa,KAAO;IACpB,aAAa,KAAO;IACpB,YAAY,KAAO;IACnB,iBAAiB,KAAO;IACxB,eAAe,KAAO;IACtB,QAAQ,KAAO;IAGf,UAAU,KAAO;IACjB,SAAS,KAAO;IAGhB,UAAU,MAAO;IACjB,WAAW,MAAO;IAClB,cAAc,MAAO;IAGrB,wBAAwB,MAAO;IAK/B,YAAY,MAAO;IACnB,YAAY,MAAO;IAEnB,UAAU,MAAO;IACjB,KAAK,MAAO;CACb;AAED,eAAO,MAAM,sCAAsC,EAAG,+BAAwC,CAAC;AAC/F,eAAO,MAAM,sCAAsC,EAAG,2BAAoC,CAAC;AAE3F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAAE,GAAG,OAAO,CAGnH;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,gBAAgB,QAAmB,CAAC;AAIjD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IAExB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,eAAO,MAAM,8BAA8B,EAAG,mBAA4B,CAAC;AAC3E,MAAM,MAAM,mBAAmB,GAAG,OAAO,8BAA8B,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB,EAAE,MAAM,CAAC;IACjC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB;uEACmE;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"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"}

package/dist/types/protocol.js

@@ -21,6 +21,8 @@ export var MessageType;
     MessageType[MessageType["NeedFreeUsageAuth"] = 85] = "NeedFreeUsageAuth";
     MessageType[MessageType["PaymentRequired"] = 86] = "PaymentRequired";
     MessageType[MessageType["NeedAuth"] = 88] = "NeedAuth";
+    MessageType[MessageType["CloseChannelRequest"] = 89] = "CloseChannelRequest";
+    MessageType[MessageType["CloseChannelResult"] = 90] = "CloseChannelResult";
     // Report message types
     MessageType[MessageType["PeerReport"] = 96] = "PeerReport";
     MessageType[MessageType["ReportAck"] = 97] = "ReportAck";
@@ -39,11 +41,33 @@ export var MessageType;
 })(MessageType || (MessageType = {}));
 export const CONNECTION_CAPABILITY_RESPONSE_AUTH_V1 = 'verification.response-auth.v1';
 export const CONNECTION_CAPABILITY_RELAYS_SWEEPS_V1 = 'payments.relays-sweeps.v1';
+/** Seller honours buyer-initiated cooperative channel close (0x59 / 0x5A). */
+export const CONNECTION_CAPABILITY_COOPERATIVE_CLOSE_V1 = 'payments.cooperative-close.v1';
 export function peerRelaysSweeps(peer) {
     return peer.capabilities?.includes(CONNECTION_CAPABILITY_RELAYS_SWEEPS_V1) === true
         || peer.metadata?.capabilities?.includes(CONNECTION_CAPABILITY_RELAYS_SWEEPS_V1) === true;
 }
+export function peerSupportsCooperativeClose(peer) {
+    return peer.capabilities?.includes(CONNECTION_CAPABILITY_COOPERATIVE_CLOSE_V1) === true
+        || peer.metadata?.capabilities?.includes(CONNECTION_CAPABILITY_COOPERATIVE_CLOSE_V1) === true;
+}
 export const FRAME_HEADER_SIZE = 9;
 export const MAX_PAYLOAD_SIZE = 64 * 1024 * 1024;
 export const PAYMENT_CODE_CHANNEL_EXHAUSTED = 'channel_exhausted';
+/** Why a seller declined to close a channel on request. */
+export const CLOSE_CHANNEL_REJECT_CODES = [
+    /** Seller is still serving requests for this buyer — retry shortly. */
+    'busy',
+    /** Seller has served work the buyer has not signed for yet. A NeedAuth was
+     *  sent alongside this result; sign `requiredCumulativeAmount` and retry. */
+    'pending_auth',
+    /** No active channel for this buyer, or `channelId` does not match it. */
+    'no_channel',
+    /** The attached SpendingAuth failed verification. */
+    'invalid_auth',
+    /** The on-chain close() call failed. `reason` carries the revert text. */
+    'close_failed',
+    /** Seller has no payment manager configured. */
+    'unsupported',
+];
 //# sourceMappingURL=protocol.js.map

package/dist/types/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WA4CX;AA5CD,WAAY,WAAW;IACrB,+DAAoB,CAAA;IACpB,6DAAmB,CAAA;IACnB,8CAAW,CAAA;IACX,8CAAW,CAAA;IACX,4DAAkB,CAAA;IAClB,8DAAmB,CAAA;IACnB,wEAAwB,CAAA;IACxB,oEAAsB,CAAA;IACtB,wEAAwB,CAAA;IACxB,uDAAuD;IACvD,sEAAuB,CAAA;IACvB,kEAAuB,CAAA;IAEvB,uCAAuC;IACvC,8DAAmB,CAAA;IACnB,oDAAc,CAAA;IACd,gEAAoB,CAAA;IACpB,gEAAoB,CAAA;IACpB,8DAAmB,CAAA;IACnB,wEAAwB,CAAA;IACxB,oEAAsB,CAAA;IACtB,sDAAe,CAAA;IAEf,uBAAuB;IACvB,0DAAiB,CAAA;IACjB,wDAAgB,CAAA;IAEhB,uBAAuB;IACvB,2DAAiB,CAAA;IACjB,6DAAkB,CAAA;IAClB,mEAAqB,CAAA;IAErB,kDAAkD;IAClD,uFAA+B,CAAA;IAE/B,8EAA8E;IAE9E,qCAAqC;IACrC,+DAAmB,CAAA;IACnB,+DAAmB,CAAA;IAEnB,2DAAiB,CAAA;IACjB,iDAAY,CAAA;AACd,CAAC,EA5CW,WAAW,KAAX,WAAW,QA4CtB;AAED,MAAM,CAAC,MAAM,sCAAsC,GAAG,+BAAwC,CAAC;AAC/F,MAAM,CAAC,MAAM,sCAAsC,GAAG,2BAAoC,CAAC;AAE3F,MAAM,UAAU,gBAAgB,CAAC,IAAyE;IACxG,OAAO,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,sCAAsC,CAAC,KAAK,IAAI;WAC9E,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,sCAAsC,CAAC,KAAK,IAAI,CAAC;AAC9F,CAAC;AAQD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AA+GjD,MAAM,CAAC,MAAM,8BAA8B,GAAG,mBAA4B,CAAC"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/types/protocol.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WA8CX;AA9CD,WAAY,WAAW;IACrB,+DAAoB,CAAA;IACpB,6DAAmB,CAAA;IACnB,8CAAW,CAAA;IACX,8CAAW,CAAA;IACX,4DAAkB,CAAA;IAClB,8DAAmB,CAAA;IACnB,wEAAwB,CAAA;IACxB,oEAAsB,CAAA;IACtB,wEAAwB,CAAA;IACxB,uDAAuD;IACvD,sEAAuB,CAAA;IACvB,kEAAuB,CAAA;IAEvB,uCAAuC;IACvC,8DAAmB,CAAA;IACnB,oDAAc,CAAA;IACd,gEAAoB,CAAA;IACpB,gEAAoB,CAAA;IACpB,8DAAmB,CAAA;IACnB,wEAAwB,CAAA;IACxB,oEAAsB,CAAA;IACtB,sDAAe,CAAA;IACf,4EAA0B,CAAA;IAC1B,0EAAyB,CAAA;IAEzB,uBAAuB;IACvB,0DAAiB,CAAA;IACjB,wDAAgB,CAAA;IAEhB,uBAAuB;IACvB,2DAAiB,CAAA;IACjB,6DAAkB,CAAA;IAClB,mEAAqB,CAAA;IAErB,kDAAkD;IAClD,uFAA+B,CAAA;IAE/B,8EAA8E;IAE9E,qCAAqC;IACrC,+DAAmB,CAAA;IACnB,+DAAmB,CAAA;IAEnB,2DAAiB,CAAA;IACjB,iDAAY,CAAA;AACd,CAAC,EA9CW,WAAW,KAAX,WAAW,QA8CtB;AAED,MAAM,CAAC,MAAM,sCAAsC,GAAG,+BAAwC,CAAC;AAC/F,MAAM,CAAC,MAAM,sCAAsC,GAAG,2BAAoC,CAAC;AAC3F,8EAA8E;AAC9E,MAAM,CAAC,MAAM,0CAA0C,GAAG,+BAAwC,CAAC;AAEnG,MAAM,UAAU,gBAAgB,CAAC,IAAyE;IACxG,OAAO,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,sCAAsC,CAAC,KAAK,IAAI;WAC9E,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,sCAAsC,CAAC,KAAK,IAAI,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,IAAyE;IAEzE,OAAO,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,0CAA0C,CAAC,KAAK,IAAI;WAClF,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,0CAA0C,CAAC,KAAK,IAAI,CAAC;AAClG,CAAC;AAQD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AA+GjD,MAAM,CAAC,MAAM,8BAA8B,GAAG,mBAA4B,CAAC;AAgE3E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,uEAAuE;IACvE,MAAM;IACN;iFAC6E;IAC7E,cAAc;IACd,0EAA0E;IAC1E,YAAY;IACZ,qDAAqD;IACrD,cAAc;IACd,0EAA0E;IAC1E,cAAc;IACd,gDAAgD;IAChD,aAAa;CACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antseed/node",
-  "version": "0.2.99",
+  "version": "0.2.101",
   "description": "Antseed Network protocol SDK — P2P inference marketplace",
   "type": "module",
   "files": [