ox 0.14.26 → 0.14.27

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ox
 
+## 0.14.27
+
+### Patch Changes
+
+- [#263](https://github.com/wevm/ox/pull/263) [`451a442`](https://github.com/wevm/ox/commit/451a442f7c3ba0d415ce4c212bc9b6bc7fd0034e) Thanks [@jxom](https://github.com/jxom)! - `ox/tempo`: Added the `ReceivePolicyReceipt` module for encoding/decoding TIP-1028 receive-policy claim receipts (`ClaimReceiptV1` witnesses) with `decode`, `encode`, `from`, `fromLog`, and `fromTransactionReceipt` (returns one receipt per `TransferBlocked` log).
+
 ## 0.14.26
 
 ### Patch Changes

package/_cjs/tempo/ReceivePolicyReceipt.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decode = decode;
+exports.encode = encode;
+exports.from = from;
+exports.fromLog = fromLog;
+exports.fromTransactionReceipt = fromTransactionReceipt;
+const AbiEvent = require("../core/AbiEvent.js");
+const AbiParameters = require("../core/AbiParameters.js");
+const blockedReasons = ['none', 'tokenFilter', 'receivePolicy'];
+const kinds = ['transfer', 'mint'];
+const parameters = [
+    {
+        type: 'tuple',
+        components: [
+            { name: 'version', type: 'uint8' },
+            { name: 'token', type: 'address' },
+            { name: 'recoveryAuthority', type: 'address' },
+            { name: 'originator', type: 'address' },
+            { name: 'recipient', type: 'address' },
+            { name: 'blockedAt', type: 'uint64' },
+            { name: 'blockedNonce', type: 'uint64' },
+            { name: 'blockedReason', type: 'uint8' },
+            { name: 'kind', type: 'uint8' },
+            { name: 'memo', type: 'bytes32' },
+        ],
+    },
+];
+const transferBlocked = AbiEvent.from('event TransferBlocked(address indexed token, address indexed receiver, uint64 indexed blockedNonce, uint256 amount, uint8 receiptVersion, bytes receipt)');
+function decode(receipt) {
+    const [decoded] = AbiParameters.decode(parameters, receipt);
+    return {
+        version: decoded.version,
+        token: decoded.token,
+        recoveryAuthority: decoded.recoveryAuthority,
+        originator: decoded.originator,
+        recipient: decoded.recipient,
+        blockedAt: decoded.blockedAt,
+        blockedNonce: decoded.blockedNonce,
+        blockedReason: blockedReasons[decoded.blockedReason] ?? 'none',
+        kind: kinds[decoded.kind] ?? 'transfer',
+        memo: decoded.memo,
+    };
+}
+function encode(decoded) {
+    return AbiParameters.encode(parameters, [
+        {
+            version: decoded.version,
+            token: decoded.token,
+            recoveryAuthority: decoded.recoveryAuthority,
+            originator: decoded.originator,
+            recipient: decoded.recipient,
+            blockedAt: decoded.blockedAt,
+            blockedNonce: decoded.blockedNonce,
+            blockedReason: blockedReasons.indexOf(decoded.blockedReason),
+            kind: kinds.indexOf(decoded.kind),
+            memo: decoded.memo,
+        },
+    ]);
+}
+function from(value) {
+    if (typeof value === 'string')
+        return value;
+    return encode(value);
+}
+function fromLog(log) {
+    const { receipt } = AbiEvent.decode(transferBlocked, log);
+    return receipt;
+}
+function fromTransactionReceipt(receipt) {
+    const selector = AbiEvent.getSelector(transferBlocked);
+    const receipts = [];
+    for (const log of receipt.logs ?? []) {
+        if (log.topics[0] !== selector)
+            continue;
+        receipts.push(fromLog(log));
+    }
+    return receipts;
+}
+//# sourceMappingURL=ReceivePolicyReceipt.js.map

package/_cjs/tempo/ReceivePolicyReceipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReceivePolicyReceipt.js","sourceRoot":"","sources":["../../tempo/ReceivePolicyReceipt.ts"],"names":[],"mappings":"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"}

package/_cjs/tempo/index.js

@@ -1,11 +1,12 @@
 "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.ReceivePolicyReceipt = exports.PoolId = exports.Period = exports.KeyAuthorization = exports.Channel = exports.AuthorizationTempo = void 0;
 exports.AuthorizationTempo = require("./AuthorizationTempo.js");
 exports.Channel = require("./Channel.js");
 exports.KeyAuthorization = require("./KeyAuthorization.js");
 exports.Period = require("./Period.js");
 exports.PoolId = require("./PoolId.js");
+exports.ReceivePolicyReceipt = require("./ReceivePolicyReceipt.js");
 exports.RpcSchemaTempo = require("./RpcSchemaTempo.js");
 exports.SignatureEnvelope = require("./SignatureEnvelope.js");
 exports.TempoAddress = require("./TempoAddress.js");

package/_cjs/tempo/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../tempo/index.ts"],"names":[],"mappings":";;;AAoCA,gEAA6D;AA2B7D,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;AA2B7D,0CAAuC;AAwCvC,4DAAyD;AA6BzD,wCAAqC;AAsBrC,wCAAqC;AAsBrC,oEAAiE;AAoBjE,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.26';
+exports.version = '0.14.27';
 //# sourceMappingURL=version.js.map

package/_esm/tempo/ReceivePolicyReceipt.js

@@ -0,0 +1,176 @@
+import * as AbiEvent from '../core/AbiEvent.js';
+import * as AbiParameters from '../core/AbiParameters.js';
+/** @internal */
+const blockedReasons = ['none', 'tokenFilter', 'receivePolicy'];
+/** @internal */
+const kinds = ['transfer', 'mint'];
+/** @internal ABI parameters for the `ClaimReceiptV1` witness. */
+const parameters = [
+    {
+        type: 'tuple',
+        components: [
+            { name: 'version', type: 'uint8' },
+            { name: 'token', type: 'address' },
+            { name: 'recoveryAuthority', type: 'address' },
+            { name: 'originator', type: 'address' },
+            { name: 'recipient', type: 'address' },
+            { name: 'blockedAt', type: 'uint64' },
+            { name: 'blockedNonce', type: 'uint64' },
+            { name: 'blockedReason', type: 'uint8' },
+            { name: 'kind', type: 'uint8' },
+            { name: 'memo', type: 'bytes32' },
+        ],
+    },
+];
+/** @internal `TransferBlocked` event emitted by the `ReceivePolicyGuard`. */
+const transferBlocked = AbiEvent.from('event TransferBlocked(address indexed token, address indexed receiver, uint64 indexed blockedNonce, uint256 amount, uint8 receiptVersion, bytes receipt)');
+/**
+ * Decodes a {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} (ABI-encoded
+ * `ClaimReceiptV1` witness) into its fields.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * ```
+ *
+ * @param receipt - The receive-policy receipt.
+ * @returns The decoded fields.
+ */
+export function decode(receipt) {
+    const [decoded] = AbiParameters.decode(parameters, receipt);
+    return {
+        version: decoded.version,
+        token: decoded.token,
+        recoveryAuthority: decoded.recoveryAuthority,
+        originator: decoded.originator,
+        recipient: decoded.recipient,
+        blockedAt: decoded.blockedAt,
+        blockedNonce: decoded.blockedNonce,
+        blockedReason: blockedReasons[decoded.blockedReason] ?? 'none',
+        kind: kinds[decoded.kind] ?? 'transfer',
+        memo: decoded.memo,
+    };
+}
+/**
+ * Encodes decoded fields into a
+ * {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt}. Inverse of `decode`.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * const receipt = ReceivePolicyReceipt.encode(decoded)
+ * ```
+ *
+ * @param decoded - The decoded fields.
+ * @returns The receive-policy receipt.
+ */
+export function encode(decoded) {
+    return AbiParameters.encode(parameters, [
+        {
+            version: decoded.version,
+            token: decoded.token,
+            recoveryAuthority: decoded.recoveryAuthority,
+            originator: decoded.originator,
+            recipient: decoded.recipient,
+            blockedAt: decoded.blockedAt,
+            blockedNonce: decoded.blockedNonce,
+            blockedReason: blockedReasons.indexOf(decoded.blockedReason),
+            kind: kinds.indexOf(decoded.kind),
+            memo: decoded.memo,
+        },
+    ]);
+}
+/**
+ * Normalizes a {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from either
+ * an encoded receipt (passthrough) or decoded fields.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * // From an encoded receipt (passthrough).
+ * const a = ReceivePolicyReceipt.from('0x...')
+ *
+ * // From decoded fields.
+ * const b = ReceivePolicyReceipt.from(ReceivePolicyReceipt.decode('0x...'))
+ * ```
+ *
+ * @param value - An encoded receipt or decoded fields.
+ * @returns The receive-policy receipt.
+ */
+export function from(value) {
+    if (typeof value === 'string')
+        return value;
+    return encode(value);
+}
+/**
+ * Extracts the {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from a
+ * `ReceivePolicyGuard` `TransferBlocked` log.
+ *
+ * Throws if the log is not a `TransferBlocked` event. Use
+ * `fromTransactionReceipt` to extract every blocked transfer in a transaction
+ * (which skips unrelated logs).
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipt = ReceivePolicyReceipt.fromLog(log)
+ * ```
+ *
+ * @param log - A `TransferBlocked` log (`data` & `topics`).
+ * @returns The receive-policy receipt.
+ */
+export function fromLog(log) {
+    const { receipt } = AbiEvent.decode(transferBlocked, log);
+    return receipt;
+}
+/**
+ * Extracts every {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from a
+ * transaction receipt's logs.
+ *
+ * A single transaction may block multiple inbound transfers (e.g. a batched
+ * transfer to several recipients), so this returns an array – one entry per
+ * `TransferBlocked` log, in log order. Returns an empty array when no transfers
+ * were blocked.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipts = ReceivePolicyReceipt.fromTransactionReceipt(receipt)
+ * // @log: ['0x...'] (pass each to `claim` / `burn`)
+ * ```
+ *
+ * @param receipt - The transaction receipt (or any object with `logs`).
+ * @returns The receive-policy receipts, one per blocked transfer.
+ */
+export function fromTransactionReceipt(receipt) {
+    const selector = AbiEvent.getSelector(transferBlocked);
+    const receipts = [];
+    for (const log of receipt.logs ?? []) {
+        if (log.topics[0] !== selector)
+            continue;
+        receipts.push(fromLog(log));
+    }
+    return receipts;
+}
+//# sourceMappingURL=ReceivePolicyReceipt.js.map

package/_esm/tempo/ReceivePolicyReceipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReceivePolicyReceipt.js","sourceRoot":"","sources":["../../tempo/ReceivePolicyReceipt.ts"],"names":[],"mappings":"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"}

package/_esm/tempo/index.js

@@ -148,6 +148,28 @@ export * as Period from './Period.js';
  * @category Reference
  */
 export * as PoolId from './PoolId.js';
+/**
+ * TIP-1028 receive-policy claim receipt utilities.
+ *
+ * When an inbound transfer or mint violates the recipient's receive policy, the
+ * funds are redirected to the `ReceivePolicyGuard` and a `ClaimReceiptV1`
+ * witness is emitted. This module decodes those witnesses (required to later
+ * `claim` or `burn` the blocked funds) from raw bytes or transaction receipts.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipts = ReceivePolicyReceipt.fromTransactionReceipt(receipt)
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * ```
+ *
+ * @category Reference
+ */
+export * as ReceivePolicyReceipt from './ReceivePolicyReceipt.js';
 /**
  * Union of all JSON-RPC Methods for the `tempo_` namespace.
  *

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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE;;;;;;;;;;;;;;;;;;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.26';
+export const version = '0.14.27';
 //# sourceMappingURL=version.js.map

package/_types/tempo/ReceivePolicyReceipt.d.ts

@@ -0,0 +1,168 @@
+import * as AbiEvent from '../core/AbiEvent.js';
+import * as AbiParameters from '../core/AbiParameters.js';
+import type * as Address from '../core/Address.js';
+import type * as Errors from '../core/Errors.js';
+import type * as Hex from '../core/Hex.js';
+import type { Compute } from '../core/internal/types.js';
+/**
+ * A TIP-1028 receive-policy claim receipt: the ABI-encoded `ClaimReceiptV1`
+ * witness emitted when an inbound transfer or mint violates the recipient's
+ * receive policy.
+ *
+ * This is the canonical, on-chain representation – the value passed to the
+ * `ReceivePolicyGuard`'s `claim` and `burn` functions. Use `decode` to read its
+ * fields.
+ */
+export type ReceivePolicyReceipt = Hex.Hex;
+/** Reason an inbound transfer or mint was blocked by a receive policy. */
+export type BlockedReason = 'none' | 'tokenFilter' | 'receivePolicy';
+/** Kind of inbound operation that was blocked. */
+export type Kind = 'transfer' | 'mint';
+/** A decoded {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt}. */
+export type Decoded = Compute<{
+    /** Receipt layout version. */
+    version: number;
+    /** TIP-20 token holding the blocked funds. */
+    token: Address.Address;
+    /** Recovery authority captured when the operation was blocked. */
+    recoveryAuthority: Address.Address;
+    /** Original sender (transfer) or issuer (mint). */
+    originator: Address.Address;
+    /** Addressed recipient (may be a virtual address). */
+    recipient: Address.Address;
+    /** Block timestamp when the operation was blocked. */
+    blockedAt: bigint;
+    /** Guard nonce assigned when the operation was blocked. */
+    blockedNonce: bigint;
+    /** Reason the operation was blocked. */
+    blockedReason: BlockedReason;
+    /** Whether the blocked operation was a transfer or mint. */
+    kind: Kind;
+    /** Application memo. */
+    memo: Hex.Hex;
+}>;
+/**
+ * Decodes a {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} (ABI-encoded
+ * `ClaimReceiptV1` witness) into its fields.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * ```
+ *
+ * @param receipt - The receive-policy receipt.
+ * @returns The decoded fields.
+ */
+export declare function decode(receipt: ReceivePolicyReceipt): Decoded;
+export declare namespace decode {
+    type ErrorType = AbiParameters.decode.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Encodes decoded fields into a
+ * {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt}. Inverse of `decode`.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * const receipt = ReceivePolicyReceipt.encode(decoded)
+ * ```
+ *
+ * @param decoded - The decoded fields.
+ * @returns The receive-policy receipt.
+ */
+export declare function encode(decoded: Decoded): ReceivePolicyReceipt;
+export declare namespace encode {
+    type ErrorType = AbiParameters.encode.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Normalizes a {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from either
+ * an encoded receipt (passthrough) or decoded fields.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * // From an encoded receipt (passthrough).
+ * const a = ReceivePolicyReceipt.from('0x...')
+ *
+ * // From decoded fields.
+ * const b = ReceivePolicyReceipt.from(ReceivePolicyReceipt.decode('0x...'))
+ * ```
+ *
+ * @param value - An encoded receipt or decoded fields.
+ * @returns The receive-policy receipt.
+ */
+export declare function from(value: ReceivePolicyReceipt | Decoded): ReceivePolicyReceipt;
+export declare namespace from {
+    type ErrorType = encode.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Extracts the {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from a
+ * `ReceivePolicyGuard` `TransferBlocked` log.
+ *
+ * Throws if the log is not a `TransferBlocked` event. Use
+ * `fromTransactionReceipt` to extract every blocked transfer in a transaction
+ * (which skips unrelated logs).
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipt = ReceivePolicyReceipt.fromLog(log)
+ * ```
+ *
+ * @param log - A `TransferBlocked` log (`data` & `topics`).
+ * @returns The receive-policy receipt.
+ */
+export declare function fromLog(log: fromLog.Log): ReceivePolicyReceipt;
+export declare namespace fromLog {
+    type Log = AbiEvent.decode.Log;
+    type ErrorType = AbiEvent.decode.ErrorType | Errors.GlobalErrorType;
+}
+/**
+ * Extracts every {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from a
+ * transaction receipt's logs.
+ *
+ * A single transaction may block multiple inbound transfers (e.g. a batched
+ * transfer to several recipients), so this returns an array – one entry per
+ * `TransferBlocked` log, in log order. Returns an empty array when no transfers
+ * were blocked.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipts = ReceivePolicyReceipt.fromTransactionReceipt(receipt)
+ * // @log: ['0x...'] (pass each to `claim` / `burn`)
+ * ```
+ *
+ * @param receipt - The transaction receipt (or any object with `logs`).
+ * @returns The receive-policy receipts, one per blocked transfer.
+ */
+export declare function fromTransactionReceipt(receipt: fromTransactionReceipt.Receipt): readonly ReceivePolicyReceipt[];
+export declare namespace fromTransactionReceipt {
+    type Receipt = {
+        /** Logs emitted by the transaction. */
+        logs?: readonly AbiEvent.decode.Log[] | undefined;
+    };
+    type ErrorType = AbiEvent.getSelector.ErrorType | fromLog.ErrorType | Errors.GlobalErrorType;
+}
+//# sourceMappingURL=ReceivePolicyReceipt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReceivePolicyReceipt.d.ts","sourceRoot":"","sources":["../../tempo/ReceivePolicyReceipt.ts"],"names":[],"mappings":"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"}

package/_types/tempo/index.d.ts

@@ -150,6 +150,28 @@ export * as Period from './Period.js';
  * @category Reference
  */
 export * as PoolId from './PoolId.js';
+/**
+ * TIP-1028 receive-policy claim receipt utilities.
+ *
+ * When an inbound transfer or mint violates the recipient's receive policy, the
+ * funds are redirected to the `ReceivePolicyGuard` and a `ClaimReceiptV1`
+ * witness is emitted. This module decodes those witnesses (required to later
+ * `claim` or `burn` the blocked funds) from raw bytes or transaction receipts.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipts = ReceivePolicyReceipt.fromTransactionReceipt(receipt)
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * ```
+ *
+ * @category Reference
+ */
+export * as ReceivePolicyReceipt from './ReceivePolicyReceipt.js';
 /**
  * Union of all JSON-RPC Methods for the `tempo_` namespace.
  *

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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAA;AACjE;;;;;;;;;;;;;;;;;;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.26";
+export declare const version = "0.14.27";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ox",
   "description": "Ethereum Standard Library",
-  "version": "0.14.26",
+  "version": "0.14.27",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -523,6 +523,11 @@
       "import": "./_esm/tempo/PoolId.js",
       "default": "./_cjs/tempo/PoolId.js"
     },
+    "./tempo/ReceivePolicyReceipt": {
+      "types": "./_types/tempo/ReceivePolicyReceipt.d.ts",
+      "import": "./_esm/tempo/ReceivePolicyReceipt.js",
+      "default": "./_cjs/tempo/ReceivePolicyReceipt.js"
+    },
     "./tempo/RpcSchemaTempo": {
       "types": "./_types/tempo/RpcSchemaTempo.d.ts",
       "import": "./_esm/tempo/RpcSchemaTempo.js",

package/tempo/ReceivePolicyReceipt/package.json

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

package/tempo/ReceivePolicyReceipt.test.ts

@@ -0,0 +1,198 @@
+import { AbiEvent, AbiParameters } from 'ox'
+import { ReceivePolicyReceipt } from 'ox/tempo'
+import { describe, expect, test } from 'vitest'
+
+const token = '0x20c0000000000000000000000000000000000001'
+const originator = '0x0000000000000000000000000000000000000aaa'
+const recipient = '0x0000000000000000000000000000000000000bbb'
+const zeroAddress = '0x0000000000000000000000000000000000000000'
+const zeroHash =
+  '0x0000000000000000000000000000000000000000000000000000000000000000'
+
+const witnessParameters = [
+  {
+    type: 'tuple',
+    components: [
+      { name: 'version', type: 'uint8' },
+      { name: 'token', type: 'address' },
+      { name: 'recoveryAuthority', type: 'address' },
+      { name: 'originator', type: 'address' },
+      { name: 'recipient', type: 'address' },
+      { name: 'blockedAt', type: 'uint64' },
+      { name: 'blockedNonce', type: 'uint64' },
+      { name: 'blockedReason', type: 'uint8' },
+      { name: 'kind', type: 'uint8' },
+      { name: 'memo', type: 'bytes32' },
+    ],
+  },
+] as const
+
+function encodeWitness(
+  overrides: Partial<{
+    blockedReason: number
+    kind: number
+  }> = {},
+) {
+  return AbiParameters.encode(witnessParameters, [
+    {
+      version: 1,
+      token,
+      recoveryAuthority: zeroAddress,
+      originator,
+      recipient,
+      blockedAt: 1234n,
+      blockedNonce: 5n,
+      blockedReason: overrides.blockedReason ?? 2,
+      kind: overrides.kind ?? 0,
+      memo: zeroHash,
+    },
+  ])
+}
+
+const transferBlocked = AbiEvent.from(
+  'event TransferBlocked(address indexed token, address indexed receiver, uint64 indexed blockedNonce, uint256 amount, uint8 receiptVersion, bytes receipt)',
+)
+
+function blockedLog(witness: `0x${string}`) {
+  const { topics } = AbiEvent.encode(transferBlocked, {
+    token,
+    receiver: recipient,
+    blockedNonce: 5n,
+  })
+  const data = AbiParameters.encode(
+    [{ type: 'uint256' }, { type: 'uint8' }, { type: 'bytes' }],
+    [10_000_000n, 1, witness],
+  )
+  return { data, topics: topics as readonly `0x${string}`[] }
+}
+
+describe('decode', () => {
+  test('default', () => {
+    expect(ReceivePolicyReceipt.decode(encodeWitness())).toMatchInlineSnapshot(`
+      {
+        "blockedAt": 1234n,
+        "blockedNonce": 5n,
+        "blockedReason": "receivePolicy",
+        "kind": "transfer",
+        "memo": "0x0000000000000000000000000000000000000000000000000000000000000000",
+        "originator": "0x0000000000000000000000000000000000000aaa",
+        "recipient": "0x0000000000000000000000000000000000000bbb",
+        "recoveryAuthority": "0x0000000000000000000000000000000000000000",
+        "token": "0x20c0000000000000000000000000000000000001",
+        "version": 1,
+      }
+    `)
+  })
+
+  test('behavior: kind mint', () => {
+    expect(ReceivePolicyReceipt.decode(encodeWitness({ kind: 1 })).kind).toBe(
+      'mint',
+    )
+  })
+
+  test('behavior: blocked reason token filter', () => {
+    expect(
+      ReceivePolicyReceipt.decode(encodeWitness({ blockedReason: 1 }))
+        .blockedReason,
+    ).toBe('tokenFilter')
+  })
+})
+
+describe('encode', () => {
+  test('round-trips with decode', () => {
+    const witness = encodeWitness()
+    expect(
+      ReceivePolicyReceipt.encode(ReceivePolicyReceipt.decode(witness)),
+    ).toBe(witness)
+  })
+
+  test('behavior: maps enum strings back to indices', () => {
+    const receipt = ReceivePolicyReceipt.decode(
+      encodeWitness({ blockedReason: 1, kind: 1 }),
+    )
+    const reencoded = ReceivePolicyReceipt.encode(receipt)
+    expect(ReceivePolicyReceipt.decode(reencoded)).toEqual(receipt)
+  })
+})
+
+describe('fromLog', () => {
+  test('default', () => {
+    const witness = encodeWitness()
+    expect(ReceivePolicyReceipt.fromLog(blockedLog(witness))).toBe(witness)
+  })
+
+  test('error: non-matching log', () => {
+    expect(() =>
+      ReceivePolicyReceipt.fromLog({ data: '0x', topics: [zeroHash] }),
+    ).toThrow()
+  })
+})
+
+describe('from', () => {
+  test('passthrough encoded receipt', () => {
+    const witness = encodeWitness()
+    expect(ReceivePolicyReceipt.from(witness)).toBe(witness)
+  })
+
+  test('from decoded fields', () => {
+    const witness = encodeWitness()
+    expect(
+      ReceivePolicyReceipt.from(ReceivePolicyReceipt.decode(witness)),
+    ).toBe(witness)
+  })
+})
+
+describe('fromTransactionReceipt', () => {
+  test('single blocked transfer', () => {
+    const witness = encodeWitness()
+    const receipts = ReceivePolicyReceipt.fromTransactionReceipt({
+      logs: [blockedLog(witness)],
+    })
+    expect(receipts).toHaveLength(1)
+    expect(receipts[0]).toBe(witness)
+  })
+
+  test('multiple blocked transfers', () => {
+    const receipts = ReceivePolicyReceipt.fromTransactionReceipt({
+      logs: [
+        blockedLog(encodeWitness()),
+        blockedLog(encodeWitness({ kind: 1 })),
+      ],
+    })
+    expect(receipts).toHaveLength(2)
+    expect(ReceivePolicyReceipt.decode(receipts[0]!).kind).toBe('transfer')
+    expect(ReceivePolicyReceipt.decode(receipts[1]!).kind).toBe('mint')
+  })
+
+  test('ignores unrelated logs', () => {
+    const receipts = ReceivePolicyReceipt.fromTransactionReceipt({
+      logs: [
+        {
+          data: '0x',
+          topics: [zeroHash],
+        },
+        blockedLog(encodeWitness()),
+      ],
+    })
+    expect(receipts).toHaveLength(1)
+  })
+
+  test('behavior: no logs', () => {
+    expect(ReceivePolicyReceipt.fromTransactionReceipt({})).toEqual([])
+    expect(ReceivePolicyReceipt.fromTransactionReceipt({ logs: [] })).toEqual(
+      [],
+    )
+  })
+})
+
+test('exports', () => {
+  expect(Object.keys(ReceivePolicyReceipt)).toMatchInlineSnapshot(`
+    [
+      "decode",
+      "encode",
+      "from",
+      "fromLog",
+      "fromTransactionReceipt",
+    ]
+  `)
+})

package/tempo/ReceivePolicyReceipt.ts

@@ -0,0 +1,263 @@
+import * as AbiEvent from '../core/AbiEvent.js'
+import * as AbiParameters from '../core/AbiParameters.js'
+import type * as Address from '../core/Address.js'
+import type * as Errors from '../core/Errors.js'
+import type * as Hex from '../core/Hex.js'
+import type { Compute } from '../core/internal/types.js'
+
+/**
+ * A TIP-1028 receive-policy claim receipt: the ABI-encoded `ClaimReceiptV1`
+ * witness emitted when an inbound transfer or mint violates the recipient's
+ * receive policy.
+ *
+ * This is the canonical, on-chain representation – the value passed to the
+ * `ReceivePolicyGuard`'s `claim` and `burn` functions. Use `decode` to read its
+ * fields.
+ */
+export type ReceivePolicyReceipt = Hex.Hex
+
+/** Reason an inbound transfer or mint was blocked by a receive policy. */
+export type BlockedReason = 'none' | 'tokenFilter' | 'receivePolicy'
+
+/** Kind of inbound operation that was blocked. */
+export type Kind = 'transfer' | 'mint'
+
+/** A decoded {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt}. */
+export type Decoded = Compute<{
+  /** Receipt layout version. */
+  version: number
+  /** TIP-20 token holding the blocked funds. */
+  token: Address.Address
+  /** Recovery authority captured when the operation was blocked. */
+  recoveryAuthority: Address.Address
+  /** Original sender (transfer) or issuer (mint). */
+  originator: Address.Address
+  /** Addressed recipient (may be a virtual address). */
+  recipient: Address.Address
+  /** Block timestamp when the operation was blocked. */
+  blockedAt: bigint
+  /** Guard nonce assigned when the operation was blocked. */
+  blockedNonce: bigint
+  /** Reason the operation was blocked. */
+  blockedReason: BlockedReason
+  /** Whether the blocked operation was a transfer or mint. */
+  kind: Kind
+  /** Application memo. */
+  memo: Hex.Hex
+}>
+
+/** @internal */
+const blockedReasons = ['none', 'tokenFilter', 'receivePolicy'] as const
+
+/** @internal */
+const kinds = ['transfer', 'mint'] as const
+
+/** @internal ABI parameters for the `ClaimReceiptV1` witness. */
+const parameters = [
+  {
+    type: 'tuple',
+    components: [
+      { name: 'version', type: 'uint8' },
+      { name: 'token', type: 'address' },
+      { name: 'recoveryAuthority', type: 'address' },
+      { name: 'originator', type: 'address' },
+      { name: 'recipient', type: 'address' },
+      { name: 'blockedAt', type: 'uint64' },
+      { name: 'blockedNonce', type: 'uint64' },
+      { name: 'blockedReason', type: 'uint8' },
+      { name: 'kind', type: 'uint8' },
+      { name: 'memo', type: 'bytes32' },
+    ],
+  },
+] as const
+
+/** @internal `TransferBlocked` event emitted by the `ReceivePolicyGuard`. */
+const transferBlocked = AbiEvent.from(
+  'event TransferBlocked(address indexed token, address indexed receiver, uint64 indexed blockedNonce, uint256 amount, uint8 receiptVersion, bytes receipt)',
+)
+
+/**
+ * Decodes a {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} (ABI-encoded
+ * `ClaimReceiptV1` witness) into its fields.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * ```
+ *
+ * @param receipt - The receive-policy receipt.
+ * @returns The decoded fields.
+ */
+export function decode(receipt: ReceivePolicyReceipt): Decoded {
+  const [decoded] = AbiParameters.decode(parameters, receipt)
+  return {
+    version: decoded.version,
+    token: decoded.token,
+    recoveryAuthority: decoded.recoveryAuthority,
+    originator: decoded.originator,
+    recipient: decoded.recipient,
+    blockedAt: decoded.blockedAt,
+    blockedNonce: decoded.blockedNonce,
+    blockedReason: blockedReasons[decoded.blockedReason] ?? 'none',
+    kind: kinds[decoded.kind] ?? 'transfer',
+    memo: decoded.memo,
+  }
+}
+
+export declare namespace decode {
+  type ErrorType = AbiParameters.decode.ErrorType | Errors.GlobalErrorType
+}
+
+/**
+ * Encodes decoded fields into a
+ * {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt}. Inverse of `decode`.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * const receipt = ReceivePolicyReceipt.encode(decoded)
+ * ```
+ *
+ * @param decoded - The decoded fields.
+ * @returns The receive-policy receipt.
+ */
+export function encode(decoded: Decoded): ReceivePolicyReceipt {
+  return AbiParameters.encode(parameters, [
+    {
+      version: decoded.version,
+      token: decoded.token,
+      recoveryAuthority: decoded.recoveryAuthority,
+      originator: decoded.originator,
+      recipient: decoded.recipient,
+      blockedAt: decoded.blockedAt,
+      blockedNonce: decoded.blockedNonce,
+      blockedReason: blockedReasons.indexOf(decoded.blockedReason),
+      kind: kinds.indexOf(decoded.kind),
+      memo: decoded.memo,
+    },
+  ])
+}
+
+export declare namespace encode {
+  type ErrorType = AbiParameters.encode.ErrorType | Errors.GlobalErrorType
+}
+
+/**
+ * Normalizes a {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from either
+ * an encoded receipt (passthrough) or decoded fields.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * // From an encoded receipt (passthrough).
+ * const a = ReceivePolicyReceipt.from('0x...')
+ *
+ * // From decoded fields.
+ * const b = ReceivePolicyReceipt.from(ReceivePolicyReceipt.decode('0x...'))
+ * ```
+ *
+ * @param value - An encoded receipt or decoded fields.
+ * @returns The receive-policy receipt.
+ */
+export function from(
+  value: ReceivePolicyReceipt | Decoded,
+): ReceivePolicyReceipt {
+  if (typeof value === 'string') return value
+  return encode(value)
+}
+
+export declare namespace from {
+  type ErrorType = encode.ErrorType | Errors.GlobalErrorType
+}
+
+/**
+ * Extracts the {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from a
+ * `ReceivePolicyGuard` `TransferBlocked` log.
+ *
+ * Throws if the log is not a `TransferBlocked` event. Use
+ * `fromTransactionReceipt` to extract every blocked transfer in a transaction
+ * (which skips unrelated logs).
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipt = ReceivePolicyReceipt.fromLog(log)
+ * ```
+ *
+ * @param log - A `TransferBlocked` log (`data` & `topics`).
+ * @returns The receive-policy receipt.
+ */
+export function fromLog(log: fromLog.Log): ReceivePolicyReceipt {
+  const { receipt } = AbiEvent.decode(transferBlocked, log)
+  return receipt
+}
+
+export declare namespace fromLog {
+  type Log = AbiEvent.decode.Log
+
+  type ErrorType = AbiEvent.decode.ErrorType | Errors.GlobalErrorType
+}
+
+/**
+ * Extracts every {@link ox#ReceivePolicyReceipt.ReceivePolicyReceipt} from a
+ * transaction receipt's logs.
+ *
+ * A single transaction may block multiple inbound transfers (e.g. a batched
+ * transfer to several recipients), so this returns an array – one entry per
+ * `TransferBlocked` log, in log order. Returns an empty array when no transfers
+ * were blocked.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipts = ReceivePolicyReceipt.fromTransactionReceipt(receipt)
+ * // @log: ['0x...'] (pass each to `claim` / `burn`)
+ * ```
+ *
+ * @param receipt - The transaction receipt (or any object with `logs`).
+ * @returns The receive-policy receipts, one per blocked transfer.
+ */
+export function fromTransactionReceipt(
+  receipt: fromTransactionReceipt.Receipt,
+): readonly ReceivePolicyReceipt[] {
+  const selector = AbiEvent.getSelector(transferBlocked)
+  const receipts: ReceivePolicyReceipt[] = []
+  for (const log of receipt.logs ?? []) {
+    if (log.topics[0] !== selector) continue
+    receipts.push(fromLog(log))
+  }
+  return receipts
+}
+
+export declare namespace fromTransactionReceipt {
+  type Receipt = {
+    /** Logs emitted by the transaction. */
+    logs?: readonly AbiEvent.decode.Log[] | undefined
+  }
+
+  type ErrorType =
+    | AbiEvent.getSelector.ErrorType
+    | fromLog.ErrorType
+    | Errors.GlobalErrorType
+}

package/tempo/index.ts

@@ -153,6 +153,28 @@ export * as Period from './Period.js'
  * @category Reference
  */
 export * as PoolId from './PoolId.js'
+/**
+ * TIP-1028 receive-policy claim receipt utilities.
+ *
+ * When an inbound transfer or mint violates the recipient's receive policy, the
+ * funds are redirected to the `ReceivePolicyGuard` and a `ClaimReceiptV1`
+ * witness is emitted. This module decodes those witnesses (required to later
+ * `claim` or `burn` the blocked funds) from raw bytes or transaction receipts.
+ *
+ * [TIP-1028](https://docs.tempo.xyz/protocol/tips/tip-1028)
+ *
+ * @example
+ * ```ts twoslash
+ * // @noErrors
+ * import { ReceivePolicyReceipt } from 'ox/tempo'
+ *
+ * const receipts = ReceivePolicyReceipt.fromTransactionReceipt(receipt)
+ * const decoded = ReceivePolicyReceipt.decode('0x...')
+ * ```
+ *
+ * @category Reference
+ */
+export * as ReceivePolicyReceipt from './ReceivePolicyReceipt.js'
 /**
  * Union of all JSON-RPC Methods for the `tempo_` namespace.
  *

package/version.ts

@@ -1,2 +1,2 @@
 /** @internal */
-export const version = '0.14.26'
+export const version = '0.14.27'