ox 0.14.23 → 0.14.24

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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

package/_cjs/tempo/Channel.js

@@ -7,8 +7,7 @@ exports.getVoucherSignPayload = getVoucherSignPayload;
 const AbiParameters = require("../core/AbiParameters.js");
 const Hash = require("../core/Hash.js");
 const Hex = require("../core/Hex.js");
-const TempoAddress = require("./TempoAddress.js");
-const TokenId = require("./TokenId.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');
@@ -19,14 +18,15 @@ 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, [
-        TempoAddress.resolve(value.payer),
-        TempoAddress.resolve(value.payee),
-        TempoAddress.resolve(value.operator),
-        TokenId.toAddress(value.token),
-        value.salt,
-        TempoAddress.resolve(value.authorizedSigner),
-        value.expiringNonceHash,
+        descriptor.payer,
+        descriptor.payee,
+        descriptor.operator,
+        descriptor.token,
+        descriptor.salt,
+        descriptor.authorizedSigner,
+        descriptor.expiringNonceHash,
         exports.address,
         BigInt(value.chainId),
     ]));

package/_cjs/tempo/Channel.js.map

@@ -1 +1 @@
-{"version":3,"file":"Channel.js","sourceRoot":"","sources":["../../tempo/Channel.ts"],"names":[],"mappings":";;;AAsFA,8BAcC;AA8BD,0CAUC;AA+BD,sDAiBC;AA5LD,0DAAyD;AAEzD,wCAAuC;AACvC,sCAAqC;AACrC,kDAAiD;AACjD,wCAAuC;AAEvC,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;AA+CD,SAAgB,SAAS,CAAC,KAAsB;IAC9C,OAAO,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,MAAM,CAAC,mBAAmB,EAAE;QACxC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,KAAK,CAAC,IAAI;QACV,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC5C,KAAK,CAAC,iBAAiB;QACvB,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"}
+{"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,8 +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.Channel = 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;AA0B7D,0CAAuC;AAwCvC,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.23';
+exports.version = '0.14.24';
 //# sourceMappingURL=version.js.map

package/_esm/tempo/Channel.js

@@ -1,8 +1,7 @@
 import * as AbiParameters from '../core/AbiParameters.js';
 import * as Hash from '../core/Hash.js';
 import * as Hex from '../core/Hex.js';
-import * as TempoAddress from './TempoAddress.js';
-import * as TokenId from './TokenId.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');
@@ -47,14 +46,15 @@ export const voucherTypehash = Hash.keccak256(Hex.fromString('Voucher(bytes32 ch
  * @returns The channel id.
  */
 export function computeId(value) {
+    const descriptor = ChannelDescriptor.from(value);
     return Hash.keccak256(AbiParameters.encode(channelIdParameters, [
-        TempoAddress.resolve(value.payer),
-        TempoAddress.resolve(value.payee),
-        TempoAddress.resolve(value.operator),
-        TokenId.toAddress(value.token),
-        value.salt,
-        TempoAddress.resolve(value.authorizedSigner),
-        value.expiringNonceHash,
+        descriptor.payer,
+        descriptor.payee,
+        descriptor.operator,
+        descriptor.token,
+        descriptor.salt,
+        descriptor.authorizedSigner,
+        descriptor.expiringNonceHash,
         address,
         BigInt(value.chainId),
     ]));

package/_esm/tempo/Channel.js.map

@@ -1 +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,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAEvC,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;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,OAAO,IAAI,CAAC,SAAS,CACnB,aAAa,CAAC,MAAM,CAAC,mBAAmB,EAAE;QACxC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACjC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,KAAK,CAAC,IAAI;QACV,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAC5C,KAAK,CAAC,iBAAiB;QACvB,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"}
+{"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

@@ -57,6 +57,28 @@ export * as AuthorizationTempo from './AuthorizationTempo.js';
  * @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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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.23';
+export const version = '0.14.24';
 //# sourceMappingURL=version.js.map

package/_types/tempo/Channel.d.ts

@@ -1,8 +1,7 @@
 import * as AbiParameters from '../core/AbiParameters.js';
 import * as Hash from '../core/Hash.js';
 import * as Hex from '../core/Hex.js';
-import * as TempoAddress from './TempoAddress.js';
-import * as TokenId from './TokenId.js';
+import * as ChannelDescriptor from './ChannelDescriptor.js';
 /**
  * TIP-20 channel reserve precompile address.
  */
@@ -18,22 +17,7 @@ export declare const voucherTypehash: `0x${string}`;
 /**
  * TIP-20 channel descriptor.
  */
-export type Descriptor = {
-    /** Account that funded the channel and receives refunds. */
-    payer: TempoAddress.Address;
-    /** Account that receives settled voucher payments. */
-    payee: TempoAddress.Address;
-    /** Optional relayer allowed to submit `settle` for the payee. */
-    operator: TempoAddress.Address;
-    /** TIP-20 token address held by the channel. */
-    token: TokenId.TokenIdOrAddress<TempoAddress.Address>;
-    /** User-supplied salt to distinguish otherwise identical channels. */
-    salt: Hex.Hex;
-    /** Optional signer for vouchers. Zero means `payer` signs. */
-    authorizedSigner: TempoAddress.Address;
-    /** Transaction-derived hash assigned when the channel was opened. */
-    expiringNonceHash: Hex.Hex;
-};
+export type Descriptor = ChannelDescriptor.ChannelDescriptor;
 /**
  * Computes the canonical TIP-20 channel id for a descriptor.
  *
@@ -61,11 +45,11 @@ export type Descriptor = {
  */
 export declare function computeId(value: computeId.Value): Hex.Hex;
 export declare namespace computeId {
-    type Value = Descriptor & {
+    type Value = ChannelDescriptor.from.Value & {
         /** Chain id used by the channel reserve precompile. */
         chainId: number | bigint;
     };
-    type ErrorType = AbiParameters.encode.ErrorType | Hash.keccak256.ErrorType | TempoAddress.parse.ErrorType;
+    type ErrorType = AbiParameters.encode.ErrorType | ChannelDescriptor.from.ErrorType | Hash.keccak256.ErrorType;
 }
 /**
  * Computes the EIP-712 domain separator for the TIP-20 channel reserve.

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

@@ -1 +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,YAAY,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AAkBvC;;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;IACvB,4DAA4D;IAC5D,KAAK,EAAE,YAAY,CAAC,OAAO,CAAA;IAC3B,sDAAsD;IACtD,KAAK,EAAE,YAAY,CAAC,OAAO,CAAA;IAC3B,iEAAiE;IACjE,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAA;IAC9B,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;IACrD,sEAAsE;IACtE,IAAI,EAAE,GAAG,CAAC,GAAG,CAAA;IACb,8DAA8D;IAC9D,gBAAgB,EAAE,YAAY,CAAC,OAAO,CAAA;IACtC,qEAAqE;IACrE,iBAAiB,EAAE,GAAG,CAAC,GAAG,CAAA;CAC3B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAczD;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,KAAK,KAAK,GAAG,UAAU,GAAG;QACxB,uDAAuD;QACvD,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;KACzB,CAAA;IAED,KAAK,SAAS,GACV,aAAa,CAAC,MAAM,CAAC,SAAS,GAC9B,IAAI,CAAC,SAAS,CAAC,SAAS,GACxB,YAAY,CAAC,KAAK,CAAC,SAAS,CAAA;CACjC;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"}
+{"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

@@ -59,6 +59,28 @@ export * as AuthorizationTempo from './AuthorizationTempo.js';
  * @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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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.23";
+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.23",
+  "version": "0.14.24",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -509,6 +509,11 @@
       "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.test.ts

@@ -48,12 +48,11 @@ describe('computeId', () => {
     )
   })
 
-  test('address inputs', () => {
+  test('token address input', () => {
     expect(
       Channel.computeId({
         ...descriptor,
-        payee: 'tempox0x2222222222222222222222222222222222222222',
-        token: 'tempox0x20c0000000000000000000000000000000000001',
+        token: '0x20c0000000000000000000000000000000000001',
       }),
     ).toBe(Channel.computeId(descriptor))
   })

package/tempo/Channel.ts

@@ -2,8 +2,7 @@ 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 TempoAddress from './TempoAddress.js'
-import * as TokenId from './TokenId.js'
+import * as ChannelDescriptor from './ChannelDescriptor.js'
 
 const channelIdParameters = AbiParameters.from(
   'address, address, address, address, bytes32, address, bytes32, address, uint256',
@@ -42,22 +41,7 @@ export const voucherTypehash = Hash.keccak256(
 /**
  * TIP-20 channel descriptor.
  */
-export type Descriptor = {
-  /** Account that funded the channel and receives refunds. */
-  payer: TempoAddress.Address
-  /** Account that receives settled voucher payments. */
-  payee: TempoAddress.Address
-  /** Optional relayer allowed to submit `settle` for the payee. */
-  operator: TempoAddress.Address
-  /** TIP-20 token address held by the channel. */
-  token: TokenId.TokenIdOrAddress<TempoAddress.Address>
-  /** User-supplied salt to distinguish otherwise identical channels. */
-  salt: Hex.Hex
-  /** Optional signer for vouchers. Zero means `payer` signs. */
-  authorizedSigner: TempoAddress.Address
-  /** Transaction-derived hash assigned when the channel was opened. */
-  expiringNonceHash: Hex.Hex
-}
+export type Descriptor = ChannelDescriptor.ChannelDescriptor
 
 /**
  * Computes the canonical TIP-20 channel id for a descriptor.
@@ -85,15 +69,16 @@ export type Descriptor = {
  * @returns The channel id.
  */
 export function computeId(value: computeId.Value): Hex.Hex {
+  const descriptor = ChannelDescriptor.from(value)
   return Hash.keccak256(
     AbiParameters.encode(channelIdParameters, [
-      TempoAddress.resolve(value.payer),
-      TempoAddress.resolve(value.payee),
-      TempoAddress.resolve(value.operator),
-      TokenId.toAddress(value.token),
-      value.salt,
-      TempoAddress.resolve(value.authorizedSigner),
-      value.expiringNonceHash,
+      descriptor.payer,
+      descriptor.payee,
+      descriptor.operator,
+      descriptor.token,
+      descriptor.salt,
+      descriptor.authorizedSigner,
+      descriptor.expiringNonceHash,
       address,
       BigInt(value.chainId),
     ]),
@@ -101,15 +86,15 @@ export function computeId(value: computeId.Value): Hex.Hex {
 }
 
 export declare namespace computeId {
-  type Value = Descriptor & {
+  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
-    | TempoAddress.parse.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/index.ts

@@ -61,6 +61,28 @@ export * as AuthorizationTempo from './AuthorizationTempo.js'
  * @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.23'
+export const version = '0.14.24'