ox 0.14.22 → 0.14.24

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # ox
 
+## 0.14.24
+
+### Patch Changes
+
+- [#254](https://github.com/wevm/ox/pull/254) [`d837628`](https://github.com/wevm/ox/commit/d8376284988f6c2b56d9cb18ac2b677465f3b835) Thanks [@jxom](https://github.com/jxom)! - Added `ChannelDescriptor.from` for normalizing TIP-20 channel reserve descriptors.
+
+## 0.14.23
+
+### Patch Changes
+
+- [#252](https://github.com/wevm/ox/pull/252) [`19cd833`](https://github.com/wevm/ox/commit/19cd83342bfddc682a8897f0cb5c383e8954586d) Thanks [@jxom](https://github.com/jxom)! - Added TIP-20 channel reserve constants, channel id computation, and voucher signing helpers.
+
 ## 0.14.22
 
 ### Patch Changes

package/_cjs/tempo/Channel.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.voucherTypehash = exports.closeGracePeriod = exports.address = void 0;
+exports.computeId = computeId;
+exports.domainSeparator = domainSeparator;
+exports.getVoucherSignPayload = getVoucherSignPayload;
+const AbiParameters = require("../core/AbiParameters.js");
+const Hash = require("../core/Hash.js");
+const Hex = require("../core/Hex.js");
+const ChannelDescriptor = require("./ChannelDescriptor.js");
+const channelIdParameters = AbiParameters.from('address, address, address, address, bytes32, address, bytes32, address, uint256');
+const domainSeparatorParameters = AbiParameters.from('bytes32, bytes32, bytes32, uint256, address');
+const voucherHashParameters = AbiParameters.from('bytes32, bytes32, uint96');
+const eip712DomainTypehash = Hash.keccak256(Hex.fromString('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'));
+const nameHash = Hash.keccak256(Hex.fromString('TIP20 Channel Reserve'));
+const versionHash = Hash.keccak256(Hex.fromString('1'));
+exports.address = '0x4d50500000000000000000000000000000000000';
+exports.closeGracePeriod = 900n;
+exports.voucherTypehash = Hash.keccak256(Hex.fromString('Voucher(bytes32 channelId,uint96 cumulativeAmount)'));
+function computeId(value) {
+    const descriptor = ChannelDescriptor.from(value);
+    return Hash.keccak256(AbiParameters.encode(channelIdParameters, [
+        descriptor.payer,
+        descriptor.payee,
+        descriptor.operator,
+        descriptor.token,
+        descriptor.salt,
+        descriptor.authorizedSigner,
+        descriptor.expiringNonceHash,
+        exports.address,
+        BigInt(value.chainId),
+    ]));
+}
+function domainSeparator(value) {
+    return Hash.keccak256(AbiParameters.encode(domainSeparatorParameters, [
+        eip712DomainTypehash,
+        nameHash,
+        versionHash,
+        BigInt(value.chainId),
+        exports.address,
+    ]));
+}
+function getVoucherSignPayload(value) {
+    const voucherHash = Hash.keccak256(AbiParameters.encode(voucherHashParameters, [
+        exports.voucherTypehash,
+        value.channelId,
+        value.cumulativeAmount,
+    ]));
+    return Hash.keccak256(Hex.concat('0x1901', domainSeparator({ chainId: value.chainId }), voucherHash));
+}
+//# sourceMappingURL=Channel.js.map

package/_cjs/tempo/Channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.js","sourceRoot":"","sources":["../../tempo/Channel.ts"],"names":[],"mappings":";;;AAsEA,8BAeC;AA8BD,0CAUC;AA+BD,sDAiBC;AA7KD,0DAAyD;AAEzD,wCAAuC;AACvC,sCAAqC;AACrC,4DAA2D;AAE3D,MAAM,mBAAmB,GAAG,aAAa,CAAC,IAAI,CAC5C,iFAAiF,CAClF,CAAA;AACD,MAAM,yBAAyB,GAAG,aAAa,CAAC,IAAI,CAClD,6CAA6C,CAC9C,CAAA;AACD,MAAM,qBAAqB,GAAG,aAAa,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;AAE5E,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CACzC,GAAG,CAAC,UAAU,CACZ,oFAAoF,CACrF,CACF,CAAA;AACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAA;AACxE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AAK1C,QAAA,OAAO,GAClB,4CAA+E,CAAA;AAKpE,QAAA,gBAAgB,GAAG,IAAI,CAAA;AAKvB,QAAA,eAAe,GAAG,IAAI,CAAC,SAAS,CAC3C,GAAG,CAAC,UAAU,CAAC,oDAAoD,CAAC,CACrE,CAAA;AAgCD,SAAgB,SAAS,CAAC,KAAsB;IAC9C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChD,OAAO,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,MAAM,CAAC,mBAAmB,EAAE;QACxC,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,QAAQ;QACnB,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,IAAI;QACf,UAAU,CAAC,gBAAgB;QAC3B,UAAU,CAAC,iBAAiB;QAC5B,eAAO;QACP,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;KACtB,CAAC,CACH,CAAA;AACH,CAAC;AA8BD,SAAgB,eAAe,CAAC,KAA4B;IAC1D,OAAO,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,MAAM,CAAC,yBAAyB,EAAE;QAC9C,oBAAoB;QACpB,QAAQ;QACR,WAAW;QACX,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QACrB,eAAO;KACR,CAAC,CACH,CAAA;AACH,CAAC;AA+BD,SAAgB,qBAAqB,CACnC,KAAkC;IAElC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAChC,aAAa,CAAC,MAAM,CAAC,qBAAqB,EAAE;QAC1C,uBAAe;QACf,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,gBAAgB;KACvB,CAAC,CACH,CAAA;IACD,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,CAAC,MAAM,CACR,QAAQ,EACR,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAC3C,WAAW,CACZ,CACF,CAAA;AACH,CAAC"}

package/_cjs/tempo/ChannelDescriptor.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.from = from;
+const Address = require("../core/Address.js");
+const TokenId = require("./TokenId.js");
+const zeroAddress = '0x0000000000000000000000000000000000000000';
+function from(value) {
+    const { authorizedSigner = zeroAddress, expiringNonceHash, operator = zeroAddress, payee, payer, salt, token, } = value;
+    return {
+        authorizedSigner: resolveAddress(authorizedSigner),
+        expiringNonceHash,
+        operator: resolveAddress(operator),
+        payee: resolveAddress(payee),
+        payer: resolveAddress(payer),
+        salt,
+        token: typeof token === 'string'
+            ? resolveAddress(token)
+            : TokenId.toAddress(token),
+    };
+}
+function resolveAddress(address) {
+    return Address.from(address);
+}
+//# sourceMappingURL=ChannelDescriptor.js.map

package/_cjs/tempo/ChannelDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelDescriptor.js","sourceRoot":"","sources":["../../tempo/ChannelDescriptor.ts"],"names":[],"mappings":";;AA4DA,oBAuBC;AAnFD,8CAA6C;AAG7C,wCAAuC;AAEvC,MAAM,WAAW,GACf,4CAA+E,CAAA;AAsDjF,SAAgB,IAAI,CAAC,KAAiB;IACpC,MAAM,EACJ,gBAAgB,GAAG,WAAW,EAC9B,iBAAiB,EACjB,QAAQ,GAAG,WAAW,EACtB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,GACN,GAAG,KAAK,CAAA;IAET,OAAO;QACL,gBAAgB,EAAE,cAAc,CAAC,gBAAgB,CAAC;QAClD,iBAAiB;QACjB,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;QAClC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,IAAI;QACJ,KAAK,EACH,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC;YACvB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;KAC/B,CAAA;AACH,CAAC;AA6BD,SAAS,cAAc,CAAC,OAAwB;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC9B,CAAC"}

package/_cjs/tempo/index.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZoneRpcAuthentication = exports.ZoneId = exports.VirtualMaster = exports.VirtualAddress = exports.TxEnvelopeTempo = exports.TransactionRequest = exports.TransactionReceipt = exports.Transaction = exports.TokenRole = exports.TokenId = exports.Tick = exports.TempoAddress = exports.SignatureEnvelope = exports.RpcSchemaTempo = exports.PoolId = exports.Period = exports.KeyAuthorization = exports.AuthorizationTempo = void 0;
+exports.ZoneRpcAuthentication = exports.ZoneId = exports.VirtualMaster = exports.VirtualAddress = exports.TxEnvelopeTempo = exports.TransactionRequest = exports.TransactionReceipt = exports.Transaction = exports.TokenRole = exports.TokenId = exports.Tick = exports.TempoAddress = exports.SignatureEnvelope = exports.RpcSchemaTempo = exports.PoolId = exports.Period = exports.KeyAuthorization = exports.ChannelDescriptor = exports.Channel = exports.AuthorizationTempo = void 0;
 exports.AuthorizationTempo = require("./AuthorizationTempo.js");
+exports.Channel = require("./Channel.js");
+exports.ChannelDescriptor = require("./ChannelDescriptor.js");
 exports.KeyAuthorization = require("./KeyAuthorization.js");
 exports.Period = require("./Period.js");
 exports.PoolId = require("./PoolId.js");

package/_cjs/tempo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":";;;AAoCA,gEAA6D;AAwC7D,4DAAyD;AA6BzD,wCAAqC;AAsBrC,wCAAqC;AAoBrC,wDAAqD;AAuBrD,8DAA2D;AAmB3D,oDAAiD;AAoBjD,oCAAiC;AAqBjC,0CAAuC;AAkBvC,8CAA2C;AAkD3C,kDAA+C;AAuB/C,gEAA6D;AAqB7D,gEAA6D;AA6B7D,0DAAuD;AA4BvD,wDAAqD;AAyBrD,sDAAmD;AAqBnD,wCAAqC;AAmCrC,sEAAmE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":";;;AAoCA,gEAA6D;AA0B7D,0CAAuC;AAsBvC,8DAA2D;AAwC3D,4DAAyD;AA6BzD,wCAAqC;AAsBrC,wCAAqC;AAoBrC,wDAAqD;AAuBrD,8DAA2D;AAmB3D,oDAAiD;AAoBjD,oCAAiC;AAqBjC,0CAAuC;AAkBvC,8CAA2C;AAkD3C,kDAA+C;AAuB/C,gEAA6D;AAqB7D,gEAA6D;AA6B7D,0DAAuD;AA4BvD,wDAAqD;AAyBrD,sDAAmD;AAqBnD,wCAAqC;AAmCrC,sEAAmE"}

package/_cjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
-exports.version = '0.14.22';
+exports.version = '0.14.24';
 //# sourceMappingURL=version.js.map

package/_esm/tempo/Channel.js

@@ -0,0 +1,115 @@
+import * as AbiParameters from '../core/AbiParameters.js';
+import * as Hash from '../core/Hash.js';
+import * as Hex from '../core/Hex.js';
+import * as ChannelDescriptor from './ChannelDescriptor.js';
+const channelIdParameters = AbiParameters.from('address, address, address, address, bytes32, address, bytes32, address, uint256');
+const domainSeparatorParameters = AbiParameters.from('bytes32, bytes32, bytes32, uint256, address');
+const voucherHashParameters = AbiParameters.from('bytes32, bytes32, uint96');
+const eip712DomainTypehash = Hash.keccak256(Hex.fromString('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'));
+const nameHash = Hash.keccak256(Hex.fromString('TIP20 Channel Reserve'));
+const versionHash = Hash.keccak256(Hex.fromString('1'));
+/**
+ * TIP-20 channel reserve precompile address.
+ */
+export const address = '0x4d50500000000000000000000000000000000000';
+/**
+ * Delay between payer `requestClose` and `withdraw`, in seconds.
+ */
+export const closeGracePeriod = 900n;
+/**
+ * EIP-712 type hash for `Voucher(bytes32 channelId,uint96 cumulativeAmount)`.
+ */
+export const voucherTypehash = Hash.keccak256(Hex.fromString('Voucher(bytes32 channelId,uint96 cumulativeAmount)'));
+/**
+ * Computes the canonical TIP-20 channel id for a descriptor.
+ *
+ * Mirrors `computeChannelId` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const channelId = Channel.computeId({
+ *   authorizedSigner: '0x0000000000000000000000000000000000000000',
+ *   chainId: 4217,
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   operator: '0x0000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @param value - Channel descriptor and chain id.
+ * @returns The channel id.
+ */
+export function computeId(value) {
+    const descriptor = ChannelDescriptor.from(value);
+    return Hash.keccak256(AbiParameters.encode(channelIdParameters, [
+        descriptor.payer,
+        descriptor.payee,
+        descriptor.operator,
+        descriptor.token,
+        descriptor.salt,
+        descriptor.authorizedSigner,
+        descriptor.expiringNonceHash,
+        address,
+        BigInt(value.chainId),
+    ]));
+}
+/**
+ * Computes the EIP-712 domain separator for the TIP-20 channel reserve.
+ *
+ * Mirrors `domainSeparator` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const separator = Channel.domainSeparator({ chainId: 4217 })
+ * ```
+ *
+ * @param value - Chain id.
+ * @returns The EIP-712 domain separator.
+ */
+export function domainSeparator(value) {
+    return Hash.keccak256(AbiParameters.encode(domainSeparatorParameters, [
+        eip712DomainTypehash,
+        nameHash,
+        versionHash,
+        BigInt(value.chainId),
+        address,
+    ]));
+}
+/**
+ * Computes the EIP-712 sign payload for a TIP-20 channel voucher.
+ *
+ * Mirrors `getVoucherDigest` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const payload = Channel.getVoucherSignPayload({
+ *   chainId: 4217,
+ *   channelId: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   cumulativeAmount: 1n,
+ * })
+ * ```
+ *
+ * @param value - Voucher fields and chain id.
+ * @returns The voucher sign payload.
+ */
+export function getVoucherSignPayload(value) {
+    const voucherHash = Hash.keccak256(AbiParameters.encode(voucherHashParameters, [
+        voucherTypehash,
+        value.channelId,
+        value.cumulativeAmount,
+    ]));
+    return Hash.keccak256(Hex.concat('0x1901', domainSeparator({ chainId: value.chainId }), voucherHash));
+}
+//# sourceMappingURL=Channel.js.map

package/_esm/tempo/Channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.js","sourceRoot":"","sources":["../../tempo/Channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AACvC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D,MAAM,mBAAmB,GAAG,aAAa,CAAC,IAAI,CAC5C,iFAAiF,CAClF,CAAA;AACD,MAAM,yBAAyB,GAAG,aAAa,CAAC,IAAI,CAClD,6CAA6C,CAC9C,CAAA;AACD,MAAM,qBAAqB,GAAG,aAAa,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAA;AAE5E,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CACzC,GAAG,CAAC,UAAU,CACZ,oFAAoF,CACrF,CACF,CAAA;AACD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAA;AACxE,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AAEvD;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAClB,4CAA+E,CAAA;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAC3C,GAAG,CAAC,UAAU,CAAC,oDAAoD,CAAC,CACrE,CAAA;AAOD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChD,OAAO,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,MAAM,CAAC,mBAAmB,EAAE;QACxC,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,QAAQ;QACnB,UAAU,CAAC,KAAK;QAChB,UAAU,CAAC,IAAI;QACf,UAAU,CAAC,gBAAgB;QAC3B,UAAU,CAAC,iBAAiB;QAC5B,OAAO;QACP,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;KACtB,CAAC,CACH,CAAA;AACH,CAAC;AAcD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAAC,KAA4B;IAC1D,OAAO,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,MAAM,CAAC,yBAAyB,EAAE;QAC9C,oBAAoB;QACpB,QAAQ;QACR,WAAW;QACX,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QACrB,OAAO;KACR,CAAC,CACH,CAAA;AACH,CAAC;AAWD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAkC;IAElC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAChC,aAAa,CAAC,MAAM,CAAC,qBAAqB,EAAE;QAC1C,eAAe;QACf,KAAK,CAAC,SAAS;QACf,KAAK,CAAC,gBAAgB;KACvB,CAAC,CACH,CAAA;IACD,OAAO,IAAI,CAAC,SAAS,CACnB,GAAG,CAAC,MAAM,CACR,QAAQ,EACR,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,EAC3C,WAAW,CACZ,CACF,CAAA;AACH,CAAC"}

package/_esm/tempo/ChannelDescriptor.js

@@ -0,0 +1,43 @@
+import * as Address from '../core/Address.js';
+import * as TokenId from './TokenId.js';
+const zeroAddress = '0x0000000000000000000000000000000000000000';
+/**
+ * Instantiates a TIP-20 channel reserve descriptor.
+ *
+ * Accepts a TIP-20 token ID or address, and defaults `operator` and
+ * `authorizedSigner` to the zero address.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ChannelDescriptor } from 'ox/tempo'
+ *
+ * const descriptor = ChannelDescriptor.from({
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000002',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @param value - The descriptor input.
+ * @returns The normalized channel descriptor.
+ */
+export function from(value) {
+    const { authorizedSigner = zeroAddress, expiringNonceHash, operator = zeroAddress, payee, payer, salt, token, } = value;
+    return {
+        authorizedSigner: resolveAddress(authorizedSigner),
+        expiringNonceHash,
+        operator: resolveAddress(operator),
+        payee: resolveAddress(payee),
+        payer: resolveAddress(payer),
+        salt,
+        token: typeof token === 'string'
+            ? resolveAddress(token)
+            : TokenId.toAddress(token),
+    };
+}
+function resolveAddress(address) {
+    return Address.from(address);
+}
+//# sourceMappingURL=ChannelDescriptor.js.map

package/_esm/tempo/ChannelDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelDescriptor.js","sourceRoot":"","sources":["../../tempo/ChannelDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAG7C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,MAAM,WAAW,GACf,4CAA+E,CAAA;AAgCjF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,IAAI,CAAC,KAAiB;IACpC,MAAM,EACJ,gBAAgB,GAAG,WAAW,EAC9B,iBAAiB,EACjB,QAAQ,GAAG,WAAW,EACtB,KAAK,EACL,KAAK,EACL,IAAI,EACJ,KAAK,GACN,GAAG,KAAK,CAAA;IAET,OAAO;QACL,gBAAgB,EAAE,cAAc,CAAC,gBAAgB,CAAC;QAClD,iBAAiB;QACjB,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC;QAClC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;QAC5B,IAAI;QACJ,KAAK,EACH,OAAO,KAAK,KAAK,QAAQ;YACvB,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC;YACvB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;KAC/B,CAAA;AACH,CAAC;AA6BD,SAAS,cAAc,CAAC,OAAwB;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAC9B,CAAC"}

package/_esm/tempo/index.js

@@ -31,6 +31,54 @@
  * @category Reference
  */
 export * as AuthorizationTempo from './AuthorizationTempo.js';
+/**
+ * TIP-20 channel reserve constants and deterministic hashing utilities.
+ *
+ * The channel reserve precompile exposes helper methods for channel identifiers,
+ * voucher sign payloads, and its EIP-712 domain separator. These utilities compute the
+ * same values locally when the chain id and channel fields are known.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const channelId = Channel.computeId({
+ *   authorizedSigner: '0x0000000000000000000000000000000000000000',
+ *   chainId: 4217,
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   operator: '0x0000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @category Reference
+ */
+export * as Channel from './Channel.js';
+/**
+ * TIP-20 channel reserve descriptor utilities.
+ *
+ * Channel descriptors are emitted by `Channel.open` and then reused to settle,
+ * top up, close, request close, withdraw, or compute the channel ID.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ChannelDescriptor } from 'ox/tempo'
+ *
+ * const descriptor = ChannelDescriptor.from({
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @category Reference
+ */
+export * as ChannelDescriptor from './ChannelDescriptor.js';
 /**
  * Tempo key authorization utilities for provisioning and signing access keys.
  *

package/_esm/tempo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAA"}

package/_esm/version.js

@@ -1,3 +1,3 @@
 /** @internal */
-export const version = '0.14.22';
+export const version = '0.14.24';
 //# sourceMappingURL=version.js.map

package/_types/tempo/Channel.d.ts

@@ -0,0 +1,110 @@
+import * as AbiParameters from '../core/AbiParameters.js';
+import * as Hash from '../core/Hash.js';
+import * as Hex from '../core/Hex.js';
+import * as ChannelDescriptor from './ChannelDescriptor.js';
+/**
+ * TIP-20 channel reserve precompile address.
+ */
+export declare const address: "0x4d50500000000000000000000000000000000000";
+/**
+ * Delay between payer `requestClose` and `withdraw`, in seconds.
+ */
+export declare const closeGracePeriod = 900n;
+/**
+ * EIP-712 type hash for `Voucher(bytes32 channelId,uint96 cumulativeAmount)`.
+ */
+export declare const voucherTypehash: `0x${string}`;
+/**
+ * TIP-20 channel descriptor.
+ */
+export type Descriptor = ChannelDescriptor.ChannelDescriptor;
+/**
+ * Computes the canonical TIP-20 channel id for a descriptor.
+ *
+ * Mirrors `computeChannelId` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const channelId = Channel.computeId({
+ *   authorizedSigner: '0x0000000000000000000000000000000000000000',
+ *   chainId: 4217,
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   operator: '0x0000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @param value - Channel descriptor and chain id.
+ * @returns The channel id.
+ */
+export declare function computeId(value: computeId.Value): Hex.Hex;
+export declare namespace computeId {
+    type Value = ChannelDescriptor.from.Value & {
+        /** Chain id used by the channel reserve precompile. */
+        chainId: number | bigint;
+    };
+    type ErrorType = AbiParameters.encode.ErrorType | ChannelDescriptor.from.ErrorType | Hash.keccak256.ErrorType;
+}
+/**
+ * Computes the EIP-712 domain separator for the TIP-20 channel reserve.
+ *
+ * Mirrors `domainSeparator` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const separator = Channel.domainSeparator({ chainId: 4217 })
+ * ```
+ *
+ * @param value - Chain id.
+ * @returns The EIP-712 domain separator.
+ */
+export declare function domainSeparator(value: domainSeparator.Value): Hex.Hex;
+export declare namespace domainSeparator {
+    type Value = {
+        /** Chain id used by the channel reserve precompile. */
+        chainId: number | bigint;
+    };
+    type ErrorType = AbiParameters.encode.ErrorType | Hash.keccak256.ErrorType;
+}
+/**
+ * Computes the EIP-712 sign payload for a TIP-20 channel voucher.
+ *
+ * Mirrors `getVoucherDigest` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const payload = Channel.getVoucherSignPayload({
+ *   chainId: 4217,
+ *   channelId: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   cumulativeAmount: 1n,
+ * })
+ * ```
+ *
+ * @param value - Voucher fields and chain id.
+ * @returns The voucher sign payload.
+ */
+export declare function getVoucherSignPayload(value: getVoucherSignPayload.Value): Hex.Hex;
+export declare namespace getVoucherSignPayload {
+    type Value = {
+        /** Chain id used by the channel reserve precompile. */
+        chainId: number | bigint;
+        /** Channel id. */
+        channelId: Hex.Hex;
+        /** Total voucher amount signed for the channel. */
+        cumulativeAmount: bigint;
+    };
+    type ErrorType = AbiParameters.encode.ErrorType | domainSeparator.ErrorType | Hash.keccak256.ErrorType;
+}
+//# sourceMappingURL=Channel.d.ts.map

package/_types/tempo/Channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.d.ts","sourceRoot":"","sources":["../../tempo/Channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAA;AAEzD,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAA;AACvC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAA;AACrC,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAkB3D;;GAEG;AACH,eAAO,MAAM,OAAO,8CAC6D,CAAA;AAEjF;;GAEG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC;;GAEG;AACH,eAAO,MAAM,eAAe,eAE3B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,iBAAiB,CAAC,iBAAiB,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAezD;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,GAAG;QAC1C,uDAAuD;QACvD,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KACzB,CAAA;IAED,KAAK,SAAS,GACV,aAAa,CAAC,MAAM,CAAC,SAAS,GAC9B,iBAAiB,CAAC,IAAI,CAAC,SAAS,GAChC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAA;CAC7B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAUrE;AAED,MAAM,CAAC,OAAO,WAAW,eAAe,CAAC;IACvC,KAAK,KAAK,GAAG;QACX,uDAAuD;QACvD,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KACzB,CAAA;IAED,KAAK,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAA;CAC3E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,qBAAqB,CAAC,KAAK,GACjC,GAAG,CAAC,GAAG,CAeT;AAED,MAAM,CAAC,OAAO,WAAW,qBAAqB,CAAC;IAC7C,KAAK,KAAK,GAAG;QACX,uDAAuD;QACvD,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;QACxB,kBAAkB;QAClB,SAAS,EAAE,GAAG,CAAC,GAAG,CAAA;QAClB,mDAAmD;QACnD,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;IAED,KAAK,SAAS,GACV,aAAa,CAAC,MAAM,CAAC,SAAS,GAC9B,eAAe,CAAC,SAAS,GACzB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAA;CAC7B"}

package/_types/tempo/ChannelDescriptor.d.ts

@@ -0,0 +1,73 @@
+import * as Address from '../core/Address.js';
+import type * as Errors from '../core/Errors.js';
+import type * as Hex from '../core/Hex.js';
+import * as TokenId from './TokenId.js';
+/**
+ * TIP-20 channel reserve descriptor.
+ *
+ * Descriptors identify a channel without reading chain state. They are emitted
+ * by `open` and reused by `settle`, `topUp`, `close`, `requestClose`, and
+ * `withdraw`.
+ */
+export type ChannelDescriptor<addressType = Address.Address, tokenType = TokenId.TokenIdOrAddress<addressType>> = {
+    /** Account that funded the channel and receives refunds. */
+    payer: addressType;
+    /** Account that receives settled voucher payments. */
+    payee: addressType;
+    /** Optional relayer allowed to submit `settle` for the payee. */
+    operator: addressType;
+    /** TIP-20 token address held by the channel. */
+    token: tokenType;
+    /** User-supplied salt to distinguish otherwise identical channels. */
+    salt: Hex.Hex;
+    /** Optional signer for vouchers. Zero means `payer` signs. */
+    authorizedSigner: addressType;
+    /** Transaction-derived hash assigned when the channel was opened. */
+    expiringNonceHash: Hex.Hex;
+};
+/** Hex-address-normalized {@link ox#ChannelDescriptor.ChannelDescriptor}. */
+export type Resolved = ChannelDescriptor<Address.Address, Address.Address>;
+/**
+ * Instantiates a TIP-20 channel reserve descriptor.
+ *
+ * Accepts a TIP-20 token ID or address, and defaults `operator` and
+ * `authorizedSigner` to the zero address.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ChannelDescriptor } from 'ox/tempo'
+ *
+ * const descriptor = ChannelDescriptor.from({
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000002',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @param value - The descriptor input.
+ * @returns The normalized channel descriptor.
+ */
+export declare function from(value: from.Value): from.ReturnType;
+export declare namespace from {
+    type Value = {
+        /** Account that funded the channel and receives refunds. */
+        payer: Address.Address;
+        /** Account that receives settled voucher payments. */
+        payee: Address.Address;
+        /** Optional relayer allowed to submit `settle` for the payee. */
+        operator?: Address.Address | undefined;
+        /** TIP-20 token address or ID held by the channel. */
+        token: TokenId.TokenIdOrAddress<Address.Address>;
+        /** User-supplied salt to distinguish otherwise identical channels. */
+        salt: Hex.Hex;
+        /** Optional signer for vouchers. Zero means `payer` signs. */
+        authorizedSigner?: Address.Address | undefined;
+        /** Transaction-derived hash assigned when the channel was opened. */
+        expiringNonceHash: Hex.Hex;
+    };
+    type ReturnType = Resolved;
+    type ErrorType = Address.from.ErrorType | Hex.concat.ErrorType | Hex.fromNumber.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=ChannelDescriptor.d.ts.map

package/_types/tempo/ChannelDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChannelDescriptor.d.ts","sourceRoot":"","sources":["../../tempo/ChannelDescriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,KAAK,GAAG,MAAM,gBAAgB,CAAA;AAC1C,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAKvC;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAC3B,WAAW,GAAG,OAAO,CAAC,OAAO,EAC7B,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAC/C;IACF,4DAA4D;IAC5D,KAAK,EAAE,WAAW,CAAA;IAClB,sDAAsD;IACtD,KAAK,EAAE,WAAW,CAAA;IAClB,iEAAiE;IACjE,QAAQ,EAAE,WAAW,CAAA;IACrB,gDAAgD;IAChD,KAAK,EAAE,SAAS,CAAA;IAChB,sEAAsE;IACtE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAA;IACb,8DAA8D;IAC9D,gBAAgB,EAAE,WAAW,CAAA;IAC7B,qEAAqE;IACrE,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAA;CAC3B,CAAA;AAED,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;AAE1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,CAuBvD;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAK,KAAK,GAAG;QACX,4DAA4D;QAC5D,KAAK,EAAE,OAAO,CAAC,OAAO,CAAA;QACtB,sDAAsD;QACtD,KAAK,EAAE,OAAO,CAAC,OAAO,CAAA;QACtB,iEAAiE;QACjE,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAA;QACtC,sDAAsD;QACtD,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAChD,sEAAsE;QACtE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAA;QACb,8DAA8D;QAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,SAAS,CAAA;QAC9C,qEAAqE;QACrE,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAA;KAC3B,CAAA;IAED,KAAK,UAAU,GAAG,QAAQ,CAAA;IAE1B,KAAK,SAAS,GACV,OAAO,CAAC,IAAI,CAAC,SAAS,GACtB,GAAG,CAAC,MAAM,CAAC,SAAS,GACpB,GAAG,CAAC,UAAU,CAAC,SAAS,GACxB,MAAM,CAAC,eAAe,CAAA;CAC3B"}

package/_types/tempo/index.d.ts

@@ -33,6 +33,54 @@ export type {};
  * @category Reference
  */
 export * as AuthorizationTempo from './AuthorizationTempo.js';
+/**
+ * TIP-20 channel reserve constants and deterministic hashing utilities.
+ *
+ * The channel reserve precompile exposes helper methods for channel identifiers,
+ * voucher sign payloads, and its EIP-712 domain separator. These utilities compute the
+ * same values locally when the chain id and channel fields are known.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const channelId = Channel.computeId({
+ *   authorizedSigner: '0x0000000000000000000000000000000000000000',
+ *   chainId: 4217,
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   operator: '0x0000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @category Reference
+ */
+export * as Channel from './Channel.js';
+/**
+ * TIP-20 channel reserve descriptor utilities.
+ *
+ * Channel descriptors are emitted by `Channel.open` and then reused to settle,
+ * top up, close, request close, withdraw, or compute the channel ID.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ChannelDescriptor } from 'ox/tempo'
+ *
+ * const descriptor = ChannelDescriptor.from({
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @category Reference
+ */
+export * as ChannelDescriptor from './ChannelDescriptor.js';
 /**
  * Tempo key authorization utilities for provisioning and signing access keys.
  *

package/_types/tempo/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,YAAY,EAAE,CAAA;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,YAAY,EAAE,CAAA;AAEd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAA;AACzD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAC3D;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AACjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAA;AAC3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAC/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAA;AAC7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,eAAe,MAAM,sBAAsB,CAAA;AACvD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAA;AACrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AACrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAA"}

package/_types/version.d.ts

@@ -1,3 +1,3 @@
 /** @internal */
-export declare const version = "0.14.22";
+export declare const version = "0.14.24";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ox",
   "description": "Ethereum Standard Library",
-  "version": "0.14.22",
+  "version": "0.14.24",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -504,6 +504,16 @@
       "import": "./_esm/tempo/AuthorizationTempo.js",
       "default": "./_cjs/tempo/AuthorizationTempo.js"
     },
+    "./tempo/Channel": {
+      "types": "./_types/tempo/Channel.d.ts",
+      "import": "./_esm/tempo/Channel.js",
+      "default": "./_cjs/tempo/Channel.js"
+    },
+    "./tempo/ChannelDescriptor": {
+      "types": "./_types/tempo/ChannelDescriptor.d.ts",
+      "import": "./_esm/tempo/ChannelDescriptor.js",
+      "default": "./_cjs/tempo/ChannelDescriptor.js"
+    },
     "./tempo/KeyAuthorization": {
       "types": "./_types/tempo/KeyAuthorization.d.ts",
       "import": "./_esm/tempo/KeyAuthorization.js",

package/tempo/Channel/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../../_types/tempo/Channel.d.ts",
+  "main": "../../_cjs/tempo/Channel.js",
+  "module": "../../_esm/tempo/Channel.js"
+}

package/tempo/Channel.test.ts

@@ -0,0 +1,120 @@
+import { Hash, Hex, TypedData } from 'ox'
+import { Channel } from 'ox/tempo'
+import { describe, expect, test } from 'vitest'
+
+const descriptor = {
+  authorizedSigner: '0x3333333333333333333333333333333333333333',
+  chainId: 4217,
+  expiringNonceHash:
+    '0x0000000000000000000000000000000000000000000000000000000000000002',
+  operator: '0x0000000000000000000000000000000000000000',
+  payee: '0x2222222222222222222222222222222222222222',
+  payer: '0x1111111111111111111111111111111111111111',
+  salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+  token: 1n,
+} as const
+
+describe('address', () => {
+  test('default', () => {
+    expect(Channel.address).toMatchInlineSnapshot(
+      `"0x4d50500000000000000000000000000000000000"`,
+    )
+  })
+})
+
+describe('closeGracePeriod', () => {
+  test('default', () => {
+    expect(Channel.closeGracePeriod).toMatchInlineSnapshot(`900n`)
+  })
+})
+
+describe('voucherTypehash', () => {
+  test('default', () => {
+    expect(Channel.voucherTypehash).toBe(
+      Hash.keccak256(
+        Hex.fromString('Voucher(bytes32 channelId,uint96 cumulativeAmount)'),
+      ),
+    )
+    expect(Channel.voucherTypehash).toMatchInlineSnapshot(
+      `"0x4730b4b2fe8de522475e80e010877c5b58ad10eb07fd0436615ee123f743bbe8"`,
+    )
+  })
+})
+
+describe('computeId', () => {
+  test('default', () => {
+    expect(Channel.computeId(descriptor)).toMatchInlineSnapshot(
+      `"0xa392474fdbb5c6753e8789236893343f11200f43ba53cca09c0cda3651946ef2"`,
+    )
+  })
+
+  test('token address input', () => {
+    expect(
+      Channel.computeId({
+        ...descriptor,
+        token: '0x20c0000000000000000000000000000000000001',
+      }),
+    ).toBe(Channel.computeId(descriptor))
+  })
+
+  test('chain id bigint', () => {
+    expect(Channel.computeId({ ...descriptor, chainId: 4217n })).toBe(
+      Channel.computeId(descriptor),
+    )
+  })
+})
+
+describe('domainSeparator', () => {
+  test('default', () => {
+    const separator = Channel.domainSeparator({ chainId: descriptor.chainId })
+
+    expect(separator).toBe(
+      TypedData.domainSeparator({
+        name: 'TIP20 Channel Reserve',
+        version: '1',
+        chainId: descriptor.chainId,
+        verifyingContract: Channel.address,
+      }),
+    )
+    expect(separator).toMatchInlineSnapshot(
+      `"0x6465ffa0b0c1e7cfc1a894ba54d79615bc06fd7cc9cfec558f3df82189d17367"`,
+    )
+  })
+})
+
+describe('getVoucherSignPayload', () => {
+  test('default', () => {
+    const channelId = Channel.computeId(descriptor)
+    const cumulativeAmount = 100n
+    const payload = Channel.getVoucherSignPayload({
+      chainId: descriptor.chainId,
+      channelId,
+      cumulativeAmount,
+    })
+
+    expect(payload).toBe(
+      TypedData.getSignPayload({
+        domain: {
+          name: 'TIP20 Channel Reserve',
+          version: '1',
+          chainId: descriptor.chainId,
+          verifyingContract: Channel.address,
+        },
+        message: {
+          channelId,
+          cumulativeAmount,
+        },
+        primaryType: 'Voucher',
+        types: {
+          Voucher: [
+            { name: 'channelId', type: 'bytes32' },
+            { name: 'cumulativeAmount', type: 'uint96' },
+          ],
+        },
+      }),
+    )
+    expect(payload).toMatchInlineSnapshot(
+      `"0x22bb33a0c0d3e04c9312dd8c70c80154e953fef495dd76ffa14388a9c7f987d3"`,
+    )
+  })
+})

package/tempo/Channel.ts

@@ -0,0 +1,190 @@
+import * as AbiParameters from '../core/AbiParameters.js'
+import type * as Address from '../core/Address.js'
+import * as Hash from '../core/Hash.js'
+import * as Hex from '../core/Hex.js'
+import * as ChannelDescriptor from './ChannelDescriptor.js'
+
+const channelIdParameters = AbiParameters.from(
+  'address, address, address, address, bytes32, address, bytes32, address, uint256',
+)
+const domainSeparatorParameters = AbiParameters.from(
+  'bytes32, bytes32, bytes32, uint256, address',
+)
+const voucherHashParameters = AbiParameters.from('bytes32, bytes32, uint96')
+
+const eip712DomainTypehash = Hash.keccak256(
+  Hex.fromString(
+    'EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)',
+  ),
+)
+const nameHash = Hash.keccak256(Hex.fromString('TIP20 Channel Reserve'))
+const versionHash = Hash.keccak256(Hex.fromString('1'))
+
+/**
+ * TIP-20 channel reserve precompile address.
+ */
+export const address =
+  '0x4d50500000000000000000000000000000000000' as const satisfies Address.Address
+
+/**
+ * Delay between payer `requestClose` and `withdraw`, in seconds.
+ */
+export const closeGracePeriod = 900n
+
+/**
+ * EIP-712 type hash for `Voucher(bytes32 channelId,uint96 cumulativeAmount)`.
+ */
+export const voucherTypehash = Hash.keccak256(
+  Hex.fromString('Voucher(bytes32 channelId,uint96 cumulativeAmount)'),
+)
+
+/**
+ * TIP-20 channel descriptor.
+ */
+export type Descriptor = ChannelDescriptor.ChannelDescriptor
+
+/**
+ * Computes the canonical TIP-20 channel id for a descriptor.
+ *
+ * Mirrors `computeChannelId` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const channelId = Channel.computeId({
+ *   authorizedSigner: '0x0000000000000000000000000000000000000000',
+ *   chainId: 4217,
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   operator: '0x0000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @param value - Channel descriptor and chain id.
+ * @returns The channel id.
+ */
+export function computeId(value: computeId.Value): Hex.Hex {
+  const descriptor = ChannelDescriptor.from(value)
+  return Hash.keccak256(
+    AbiParameters.encode(channelIdParameters, [
+      descriptor.payer,
+      descriptor.payee,
+      descriptor.operator,
+      descriptor.token,
+      descriptor.salt,
+      descriptor.authorizedSigner,
+      descriptor.expiringNonceHash,
+      address,
+      BigInt(value.chainId),
+    ]),
+  )
+}
+
+export declare namespace computeId {
+  type Value = ChannelDescriptor.from.Value & {
+    /** Chain id used by the channel reserve precompile. */
+    chainId: number | bigint
+  }
+
+  type ErrorType =
+    | AbiParameters.encode.ErrorType
+    | ChannelDescriptor.from.ErrorType
+    | Hash.keccak256.ErrorType
+}
+
+/**
+ * Computes the EIP-712 domain separator for the TIP-20 channel reserve.
+ *
+ * Mirrors `domainSeparator` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const separator = Channel.domainSeparator({ chainId: 4217 })
+ * ```
+ *
+ * @param value - Chain id.
+ * @returns The EIP-712 domain separator.
+ */
+export function domainSeparator(value: domainSeparator.Value): Hex.Hex {
+  return Hash.keccak256(
+    AbiParameters.encode(domainSeparatorParameters, [
+      eip712DomainTypehash,
+      nameHash,
+      versionHash,
+      BigInt(value.chainId),
+      address,
+    ]),
+  )
+}
+
+export declare namespace domainSeparator {
+  type Value = {
+    /** Chain id used by the channel reserve precompile. */
+    chainId: number | bigint
+  }
+
+  type ErrorType = AbiParameters.encode.ErrorType | Hash.keccak256.ErrorType
+}
+
+/**
+ * Computes the EIP-712 sign payload for a TIP-20 channel voucher.
+ *
+ * Mirrors `getVoucherDigest` on the TIP-20 channel reserve precompile without
+ * performing an RPC call.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const payload = Channel.getVoucherSignPayload({
+ *   chainId: 4217,
+ *   channelId: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   cumulativeAmount: 1n,
+ * })
+ * ```
+ *
+ * @param value - Voucher fields and chain id.
+ * @returns The voucher sign payload.
+ */
+export function getVoucherSignPayload(
+  value: getVoucherSignPayload.Value,
+): Hex.Hex {
+  const voucherHash = Hash.keccak256(
+    AbiParameters.encode(voucherHashParameters, [
+      voucherTypehash,
+      value.channelId,
+      value.cumulativeAmount,
+    ]),
+  )
+  return Hash.keccak256(
+    Hex.concat(
+      '0x1901',
+      domainSeparator({ chainId: value.chainId }),
+      voucherHash,
+    ),
+  )
+}
+
+export declare namespace getVoucherSignPayload {
+  type Value = {
+    /** Chain id used by the channel reserve precompile. */
+    chainId: number | bigint
+    /** Channel id. */
+    channelId: Hex.Hex
+    /** Total voucher amount signed for the channel. */
+    cumulativeAmount: bigint
+  }
+
+  type ErrorType =
+    | AbiParameters.encode.ErrorType
+    | domainSeparator.ErrorType
+    | Hash.keccak256.ErrorType
+}

package/tempo/ChannelDescriptor/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../../_types/tempo/ChannelDescriptor.d.ts",
+  "main": "../../_cjs/tempo/ChannelDescriptor.js",
+  "module": "../../_esm/tempo/ChannelDescriptor.js"
+}

package/tempo/ChannelDescriptor.test.ts

@@ -0,0 +1,93 @@
+import type { Address } from 'ox'
+import { ChannelDescriptor } from 'ox/tempo'
+import { describe, expect, test } from 'vitest'
+
+describe('from', () => {
+  test('default', () => {
+    expect(
+      ChannelDescriptor.from({
+        authorizedSigner: '0x3333333333333333333333333333333333333333',
+        expiringNonceHash:
+          '0x0000000000000000000000000000000000000000000000000000000000000002',
+        operator: '0x4444444444444444444444444444444444444444',
+        payee: '0x2222222222222222222222222222222222222222',
+        payer: '0x1111111111111111111111111111111111111111',
+        salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+        token: 1n,
+      }),
+    ).toMatchInlineSnapshot(`
+      {
+        "authorizedSigner": "0x3333333333333333333333333333333333333333",
+        "expiringNonceHash": "0x0000000000000000000000000000000000000000000000000000000000000002",
+        "operator": "0x4444444444444444444444444444444444444444",
+        "payee": "0x2222222222222222222222222222222222222222",
+        "payer": "0x1111111111111111111111111111111111111111",
+        "salt": "0x0000000000000000000000000000000000000000000000000000000000000001",
+        "token": "0x20c0000000000000000000000000000000000001",
+      }
+    `)
+  })
+
+  test('default values', () => {
+    expect(
+      ChannelDescriptor.from({
+        expiringNonceHash:
+          '0x0000000000000000000000000000000000000000000000000000000000000002',
+        payee: '0x2222222222222222222222222222222222222222',
+        payer: '0x1111111111111111111111111111111111111111',
+        salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+        token: 1n,
+      }),
+    ).toMatchInlineSnapshot(`
+      {
+        "authorizedSigner": "0x0000000000000000000000000000000000000000",
+        "expiringNonceHash": "0x0000000000000000000000000000000000000000000000000000000000000002",
+        "operator": "0x0000000000000000000000000000000000000000",
+        "payee": "0x2222222222222222222222222222222222222222",
+        "payer": "0x1111111111111111111111111111111111111111",
+        "salt": "0x0000000000000000000000000000000000000000000000000000000000000001",
+        "token": "0x20c0000000000000000000000000000000000001",
+      }
+    `)
+  })
+
+  test('token address input', () => {
+    expect(
+      ChannelDescriptor.from({
+        authorizedSigner: '0x3333333333333333333333333333333333333333',
+        expiringNonceHash:
+          '0x0000000000000000000000000000000000000000000000000000000000000002',
+        operator: '0x4444444444444444444444444444444444444444',
+        payee: '0x2222222222222222222222222222222222222222',
+        payer: '0x1111111111111111111111111111111111111111',
+        salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+        token: '0x20c0000000000000000000000000000000000001',
+      }),
+    ).toMatchInlineSnapshot(`
+      {
+        "authorizedSigner": "0x3333333333333333333333333333333333333333",
+        "expiringNonceHash": "0x0000000000000000000000000000000000000000000000000000000000000002",
+        "operator": "0x4444444444444444444444444444444444444444",
+        "payee": "0x2222222222222222222222222222222222222222",
+        "payer": "0x1111111111111111111111111111111111111111",
+        "salt": "0x0000000000000000000000000000000000000000000000000000000000000001",
+        "token": "0x20c0000000000000000000000000000000000001",
+      }
+    `)
+  })
+
+  test('return type', () => {
+    const descriptor = ChannelDescriptor.from({
+      expiringNonceHash:
+        '0x0000000000000000000000000000000000000000000000000000000000000002',
+      payee: '0x2222222222222222222222222222222222222222',
+      payer: '0x1111111111111111111111111111111111111111',
+      salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+      token: 1n,
+    })
+
+    descriptor satisfies ChannelDescriptor.Resolved
+    descriptor.payer satisfies Address.Address
+    descriptor.token satisfies Address.Address
+  })
+})

package/tempo/ChannelDescriptor.ts

@@ -0,0 +1,115 @@
+import * as Address from '../core/Address.js'
+import type * as Errors from '../core/Errors.js'
+import type * as Hex from '../core/Hex.js'
+import * as TokenId from './TokenId.js'
+
+const zeroAddress =
+  '0x0000000000000000000000000000000000000000' as const satisfies Address.Address
+
+/**
+ * TIP-20 channel reserve descriptor.
+ *
+ * Descriptors identify a channel without reading chain state. They are emitted
+ * by `open` and reused by `settle`, `topUp`, `close`, `requestClose`, and
+ * `withdraw`.
+ */
+export type ChannelDescriptor<
+  addressType = Address.Address,
+  tokenType = TokenId.TokenIdOrAddress<addressType>,
+> = {
+  /** Account that funded the channel and receives refunds. */
+  payer: addressType
+  /** Account that receives settled voucher payments. */
+  payee: addressType
+  /** Optional relayer allowed to submit `settle` for the payee. */
+  operator: addressType
+  /** TIP-20 token address held by the channel. */
+  token: tokenType
+  /** User-supplied salt to distinguish otherwise identical channels. */
+  salt: Hex.Hex
+  /** Optional signer for vouchers. Zero means `payer` signs. */
+  authorizedSigner: addressType
+  /** Transaction-derived hash assigned when the channel was opened. */
+  expiringNonceHash: Hex.Hex
+}
+
+/** Hex-address-normalized {@link ox#ChannelDescriptor.ChannelDescriptor}. */
+export type Resolved = ChannelDescriptor<Address.Address, Address.Address>
+
+/**
+ * Instantiates a TIP-20 channel reserve descriptor.
+ *
+ * Accepts a TIP-20 token ID or address, and defaults `operator` and
+ * `authorizedSigner` to the zero address.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ChannelDescriptor } from 'ox/tempo'
+ *
+ * const descriptor = ChannelDescriptor.from({
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000002',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @param value - The descriptor input.
+ * @returns The normalized channel descriptor.
+ */
+export function from(value: from.Value): from.ReturnType {
+  const {
+    authorizedSigner = zeroAddress,
+    expiringNonceHash,
+    operator = zeroAddress,
+    payee,
+    payer,
+    salt,
+    token,
+  } = value
+
+  return {
+    authorizedSigner: resolveAddress(authorizedSigner),
+    expiringNonceHash,
+    operator: resolveAddress(operator),
+    payee: resolveAddress(payee),
+    payer: resolveAddress(payer),
+    salt,
+    token:
+      typeof token === 'string'
+        ? resolveAddress(token)
+        : TokenId.toAddress(token),
+  }
+}
+
+export declare namespace from {
+  type Value = {
+    /** Account that funded the channel and receives refunds. */
+    payer: Address.Address
+    /** Account that receives settled voucher payments. */
+    payee: Address.Address
+    /** Optional relayer allowed to submit `settle` for the payee. */
+    operator?: Address.Address | undefined
+    /** TIP-20 token address or ID held by the channel. */
+    token: TokenId.TokenIdOrAddress<Address.Address>
+    /** User-supplied salt to distinguish otherwise identical channels. */
+    salt: Hex.Hex
+    /** Optional signer for vouchers. Zero means `payer` signs. */
+    authorizedSigner?: Address.Address | undefined
+    /** Transaction-derived hash assigned when the channel was opened. */
+    expiringNonceHash: Hex.Hex
+  }
+
+  type ReturnType = Resolved
+
+  type ErrorType =
+    | Address.from.ErrorType
+    | Hex.concat.ErrorType
+    | Hex.fromNumber.ErrorType
+    | Errors.GlobalErrorType
+}
+
+function resolveAddress(address: Address.Address): Address.Address {
+  return Address.from(address)
+}

package/tempo/ZoneRpcAuthentication.test.ts

@@ -171,7 +171,7 @@ describe('serialize', () => {
 })
 
 const credentials = import.meta.env.VITE_TEMPO_CREDENTIALS
-const rpcUrl = 'https://rpc-zone-006-private.tempoxyz.dev'
+const rpcUrl = 'https://rpc-zone-b.testnet.tempo.xyz'
 
 describe('e2e', () => {
   test.skipIf(!credentials)('succeeds with auth token', async () => {

package/tempo/index.ts

@@ -35,6 +35,54 @@ export type {}
  * @category Reference
  */
 export * as AuthorizationTempo from './AuthorizationTempo.js'
+/**
+ * TIP-20 channel reserve constants and deterministic hashing utilities.
+ *
+ * The channel reserve precompile exposes helper methods for channel identifiers,
+ * voucher sign payloads, and its EIP-712 domain separator. These utilities compute the
+ * same values locally when the chain id and channel fields are known.
+ *
+ * @example
+ * ```ts twoslash
+ * import { Channel } from 'ox/tempo'
+ *
+ * const channelId = Channel.computeId({
+ *   authorizedSigner: '0x0000000000000000000000000000000000000000',
+ *   chainId: 4217,
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   operator: '0x0000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @category Reference
+ */
+export * as Channel from './Channel.js'
+/**
+ * TIP-20 channel reserve descriptor utilities.
+ *
+ * Channel descriptors are emitted by `Channel.open` and then reused to settle,
+ * top up, close, request close, withdraw, or compute the channel ID.
+ *
+ * @example
+ * ```ts twoslash
+ * import { ChannelDescriptor } from 'ox/tempo'
+ *
+ * const descriptor = ChannelDescriptor.from({
+ *   expiringNonceHash: '0x0000000000000000000000000000000000000000000000000000000000000000',
+ *   payee: '0x2222222222222222222222222222222222222222',
+ *   payer: '0x1111111111111111111111111111111111111111',
+ *   salt: '0x0000000000000000000000000000000000000000000000000000000000000001',
+ *   token: 1n,
+ * })
+ * ```
+ *
+ * @category Reference
+ */
+export * as ChannelDescriptor from './ChannelDescriptor.js'
 /**
  * Tempo key authorization utilities for provisioning and signing access keys.
  *

package/version.ts

@@ -1,2 +1,2 @@
 /** @internal */
-export const version = '0.14.22'
+export const version = '0.14.24'