@hashspan/core 0.8.0 → 0.9.0

package/dist/index.d.cts

@@ -1,13 +1,14 @@
 import { Attributes, Context, MeterProvider, TimeInput, TracerProvider } from "@opentelemetry/api";
 //#region src/types.d.ts
 /**
- * How wallet addresses are recorded. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0004-privacy-defaults.md.
+ * How wallet addresses are recorded: `raw` in lower case, `hashed` as a hash of the lower-cased address, `off` not at
+ * all. See
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0004-privacy-defaults.md.
  */
 type AddressMode = "raw" | "hashed" | "off";
 /**
  * How error messages are recorded on exception events and span status. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0006-error-privacy.md.
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0006-error-privacy.md.
  * - `off`: error type only
  * - `sanitized`: first line, addresses per address mode, other long hex data removed
  * - `raw`: full message and stack trace, as thrown
@@ -66,7 +67,7 @@ interface TxTrackerOptions {
   /**
    * Agent identity. A field set here always wins; fields left unset are taken from the Baggage entries
    * `gen_ai.agent.id` / `gen_ai.agent.name` unless `agentFromBaggage` is false
-   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0011-agent-identity-precedence.md).
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0011-agent-identity-precedence.md).
    */
   agent?: AgentIdentity | undefined;
   /**
@@ -110,25 +111,37 @@ interface SendInput {
   functionSelector?: string | undefined;
   /** Decoded call arguments; recorded only with the `recordFunctionArguments` tracker option. */
   functionArguments?: readonly unknown[] | undefined;
+  /**
+   * The EIP-7702 authorization list of a type 4 transaction. Its length is recorded as
+   * `blockchain.tx.authorization.count`; for each well-formed entry (at most 64), its delegated address per the
+   * address mode and its chain id. Signatures and nonces are never recorded.
+   */
+  authorizations?: readonly AuthorizationInput[] | undefined;
   /**
    * When the send started, for adapters that record it after the fact
-   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0009-telemetry-off-the-call-path.md).
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0009-telemetry-off-the-call-path.md).
    * Omit it otherwise: with an explicit start time, the SDK measures the span by the wall clock, so pass the end time
    * to the handle too.
    */
   startTime?: TimeInput | undefined;
 }
+/** One EIP-7702 authorization: the contract the account delegates to, and the chain it is valid on (0: every chain). */
+interface AuthorizationInput {
+  /** The delegated contract address; `0x000...0` clears a delegation. */
+  address: string;
+  chainId: number;
+}
 /**
  * Ends a send span. Only the first call counts; methods never throw.
  * Produced by the tracker only; methods may be added in minor releases
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0014-core-api-boundary.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
  */
 interface SendHandle {
   /**
    * The parent context with the send span set. Run the call that sends the transaction in it, e.g.
    * `await context.with(send.context, () => sendSomehow())`, so that spans of wallet, RPC or HTTP instrumentation
    * nest under the send span
-   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0015-send-span-as-active-context.md).
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0015-send-span-as-active-context.md).
    * Run only that call in it: a confirm span started in it becomes a child of the send span.
    */
   readonly context: Context;
@@ -191,7 +204,7 @@ interface ReceiptLike {
   /**
    * Hash of the mined transaction. When it differs from the awaited hash, the awaited transaction was replaced: its
    * confirm span ends as `replaced` and the receipt is recorded for this hash
-   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0008-replaced-transactions.md).
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0008-replaced-transactions.md).
    */
   transactionHash?: string | undefined;
   /** Replacement reason reported by the library, when {@link transactionHash} differs from the awaited hash. */
@@ -201,7 +214,7 @@ interface ReceiptLike {
  * One wait for a transaction's receipt, joined to the transaction's shared confirm span. Only the first call counts;
  * methods never throw.
  * Produced by the tracker only; methods may be added in minor releases
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0014-core-api-boundary.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
  */
 interface ConfirmHandle {
   /** Ends the shared confirm span with the receipt, for every handle of the transaction. */
@@ -225,7 +238,7 @@ interface ConfirmHandle {
 }
 /**
  * A payment the agent authorizes and another party settles on chain, e.g. an x402 facilitator
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0013-x402-payments.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0013-x402-payments.md).
  * Values often come from a remote server: addresses, amounts and identifiers that are malformed are not recorded.
  */
 interface PaymentInput {
@@ -259,7 +272,7 @@ interface PaymentSettlement {
   status: PaymentStatus;
   /** Hash of the settling transaction; with it, a confirm span for this hash links to the payment span. */
   hash?: string | undefined;
-  /** Address that paid, when the settlement reports it; recorded instead of the input's. */
+  /** Address that paid, when the settlement reports it; recorded only when the payment's input had no payer. */
   payer?: string | undefined;
   /**
    * Amount settled, when the settlement reports it, recorded as `blockchain.payment.settled_amount`; also as
@@ -277,7 +290,7 @@ interface PaymentSettlement {
 /**
  * Ends a payment span. Only the first call counts; methods never throw.
  * Produced by the tracker only; methods may be added in minor releases
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0014-core-api-boundary.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
  */
 interface PaymentHandle {
   /** Ends the payment span with its settlement. */
@@ -302,7 +315,7 @@ interface PaymentHandle {
 }
 /**
  * A user operation of an ERC-4337 smart account, handed to a bundler
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0021-user-operations.md). It has no
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0021-user-operations.md). It has no
  * transaction of its own: the bundler includes it in a bundle transaction that the bundler sends.
  */
 interface UserOperationInput {
@@ -325,7 +338,7 @@ interface UserOperationResult {
 /**
  * Ends the send span of a user operation. Only the first call counts; methods never throw.
  * Produced by the tracker only; methods may be added in minor releases
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0014-core-api-boundary.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
  */
 interface UserOperationSendHandle {
   /**
@@ -383,7 +396,7 @@ interface UserOperationReceiptLike {
  * One wait for a user operation's receipt, joined to the operation's shared confirm span, as for transactions
  * ({@link ConfirmHandle}). Only the first call counts; methods never throw.
  * Produced by the tracker only; methods may be added in minor releases
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0014-core-api-boundary.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
  */
 interface UserOperationConfirmHandle {
   /** Ends the shared confirm span with the receipt, for every handle of the user operation. */
@@ -401,6 +414,101 @@ interface UserOperationConfirmHandle {
    */
   fail(error: unknown, options?: FailOptions): void;
 }
+/**
+ * A batch of calls handed to a wallet with EIP-5792 `wallet_sendCalls`
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0022-call-batches.md). The wallet decides
+ * how the calls reach the chain: in one transaction, several, or a user operation.
+ */
+interface CallBatchInput {
+  /** EIP-155 chain id. */
+  chainId: number;
+  /** Address of the account the calls are sent from, recorded as `blockchain.call_batch.sender` per the address mode. */
+  sender?: string | undefined;
+  /** Number of calls in the batch, recorded as `blockchain.call_batch.call_count`. */
+  callCount?: number | undefined;
+  /** When the send started, for adapters that record it after the fact; see {@link SendInput.startTime}. */
+  startTime?: TimeInput | undefined;
+}
+/** What handing a call batch to a wallet produced. */
+interface CallBatchResult {
+  /**
+   * The batch id the wallet returned, which identifies the batch with the chain id: `0x`-prefixed hex of at most 8194
+   * characters. Any other id is not recorded.
+   */
+  id: string;
+  /**
+   * Hashes of transactions the account itself sent for the batch, when the adapter knows them (viem's fallback to
+   * `eth_sendTransaction`). Each is recorded as sent by the batch's send span, so its confirm span links to it.
+   */
+  transactionHashes?: readonly string[] | undefined;
+}
+/**
+ * Ends the send span of a call batch. Only the first call counts; methods never throw.
+ * Produced by the tracker only; methods may be added in minor releases
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
+ */
+interface CallBatchSendHandle {
+  /**
+   * The parent context with the send span set. Run the call that hands the batch to the wallet in it, as for
+   * {@link SendHandle.context}.
+   */
+  readonly context: Context;
+  /** Ends the send span successfully once the batch id is known. */
+  end(result: CallBatchResult, options?: EndOptions): void;
+  /** Ends the send span with an error (the wallet rejected the batch, or sending it failed). */
+  fail(error: unknown, options?: FailOptions): void;
+}
+interface CallBatchConfirmInput {
+  /** EIP-155 chain id; with `id`, it identifies the batch and its confirm span. */
+  chainId: number;
+  /** The batch id awaited, as the wallet returned it. */
+  id: string;
+  /** When the wait started, for adapters that record it after the fact; see {@link SendInput.startTime}. */
+  startTime?: TimeInput | undefined;
+}
+/**
+ * Library-agnostic view of an EIP-5792 call batch status (`wallet_getCallsStatus`). Every field is optional; values
+ * come from a wallet, and malformed ones are not recorded.
+ */
+interface CallBatchStatusLike {
+  /**
+   * The EIP-5792 status code, recorded as `blockchain.call_batch.status_code`. 200 ends the confirm span as
+   * `success`, 500 as `reverted` and 600 as `partially_reverted` (`blockchain.call_batch.status`); 400 (failed without
+   * inclusion) with `error.type` `failed`; 100 (still pending) without an outcome; any other code, or none, with
+   * `error.type` `_OTHER`.
+   */
+  statusCode?: number | undefined;
+  /** Whether the wallet ran the calls atomically. */
+  atomic?: boolean | undefined;
+  /**
+   * Receipts of the transactions that carried the batch; only their hashes (validated, de-duplicated, at most 64) and
+   * the highest block number are recorded.
+   */
+  receipts?: readonly {
+    transactionHash?: string | undefined;
+    blockNumber?: bigint | number | undefined;
+  }[] | undefined;
+}
+/**
+ * One wait for a call batch's status, joined to the batch's shared confirm span, as for transactions
+ * ({@link ConfirmHandle}). Only the first call counts; methods never throw.
+ * Produced by the tracker only; methods may be added in minor releases
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
+ */
+interface CallBatchConfirmHandle {
+  /** Ends the shared confirm span with the status, for every handle of the batch. */
+  end(status: CallBatchStatusLike, options?: EndOptions): void;
+  /**
+   * Withdraws this handle because waiting for the status timed out. The confirm span ends as `timeout` only if no
+   * other handle of the batch is still waiting.
+   */
+  timeout(options?: EndOptions): void;
+  /**
+   * Withdraws this handle because the status could not be retrieved. The confirm span ends as a failure only if no
+   * other handle is still waiting.
+   */
+  fail(error: unknown, options?: FailOptions): void;
+}
 //#endregion
 //#region src/agent.d.ts
 export declare const ATTR_GEN_AI_AGENT_ID: "gen_ai.agent.id";
@@ -410,7 +518,7 @@ export declare const ATTR_GEN_AI_AGENT_NAME: "gen_ai.agent.name";
 /**
  * Attribute keys emitted by hashspan.
  *
- * Stability: development. See https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/semconv.md for
+ * Stability: development. See https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/semconv.md for
  * definitions and value types. These names are a public contract: changes follow the deprecation policy in AGENTS.md.
  */
 export declare const ATTR_BLOCKCHAIN_SYSTEM: "blockchain.system";
@@ -421,6 +529,12 @@ export declare const ATTR_BLOCKCHAIN_TX_FROM: "blockchain.tx.from";
 export declare const ATTR_BLOCKCHAIN_TX_TO: "blockchain.tx.to";
 export declare const ATTR_BLOCKCHAIN_TX_VALUE: "blockchain.tx.value";
 export declare const ATTR_BLOCKCHAIN_TX_NONCE: "blockchain.tx.nonce";
+/** Number of EIP-7702 authorizations a type 4 transaction carries. */
+export declare const ATTR_BLOCKCHAIN_TX_AUTHORIZATION_COUNT: "blockchain.tx.authorization.count";
+/** Delegated contract address of each well-formed EIP-7702 authorization, per the address mode; at most 64. */
+export declare const ATTR_BLOCKCHAIN_TX_AUTHORIZATION_ADDRESSES: "blockchain.tx.authorization.addresses";
+/** Chain id of each well-formed EIP-7702 authorization, aligned with the addresses; 0 means every chain. */
+export declare const ATTR_BLOCKCHAIN_TX_AUTHORIZATION_CHAIN_IDS: "blockchain.tx.authorization.chain_ids";
 export declare const ATTR_BLOCKCHAIN_TX_STATUS: "blockchain.tx.status";
 export declare const ATTR_BLOCKCHAIN_TX_GAS_USED: "blockchain.tx.gas.used";
 export declare const ATTR_BLOCKCHAIN_TX_EFFECTIVE_GAS_PRICE: "blockchain.tx.effective_gas_price";
@@ -434,12 +548,12 @@ export declare const ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_NAME: "blockchain.contrac
 export declare const ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_SELECTOR: "blockchain.contract.function.selector";
 /**
  * Opt-in: decoded call arguments as a JSON array. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0004-privacy-defaults.md.
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0004-privacy-defaults.md.
  */
 export declare const ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_ARGUMENTS: "blockchain.contract.function.arguments";
 /**
  * Payments settled on chain by a party other than the agent, e.g. an x402 facilitator. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0013-x402-payments.md.
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0013-x402-payments.md.
  */
 export declare const ATTR_BLOCKCHAIN_PAYMENT_PROTOCOL: "blockchain.payment.protocol";
 export declare const ATTR_BLOCKCHAIN_PAYMENT_PAYER: "blockchain.payment.payer";
@@ -452,7 +566,7 @@ export declare const ATTR_BLOCKCHAIN_PAYMENT_SETTLED_AMOUNT: "blockchain.payment
 /**
  * Whether the settlement transaction's receipt carries the payment, as checked by the adapter; absent when no check
  * was possible. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0017-x402-payment-verification.md.
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0017-x402-payment-verification.md.
  */
 export declare const ATTR_BLOCKCHAIN_PAYMENT_VERIFIED: "blockchain.payment.verified";
 /** x402's own payment fields. */
@@ -460,7 +574,7 @@ export declare const ATTR_X402_SCHEME: "x402.scheme";
 export declare const ATTR_X402_RESOURCE: "x402.resource";
 /**
  * User operations of ERC-4337 smart accounts. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0021-user-operations.md.
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0021-user-operations.md.
  */
 export declare const ATTR_BLOCKCHAIN_USER_OPERATION_HASH: "blockchain.user_operation.hash";
 export declare const ATTR_BLOCKCHAIN_USER_OPERATION_SENDER: "blockchain.user_operation.sender";
@@ -472,13 +586,32 @@ export declare const ATTR_BLOCKCHAIN_USER_OPERATION_GAS_USED: "blockchain.user_o
 /** What the operation itself paid, in wei; the bundle transaction's fee covers every operation in the bundle. */
 export declare const ATTR_BLOCKCHAIN_USER_OPERATION_GAS_COST: "blockchain.user_operation.gas.cost";
 export declare const ATTR_BLOCKCHAIN_USER_OPERATION_PAYMASTER: "blockchain.user_operation.paymaster";
+/**
+ * The batch id the wallet returned, truncated after 256 characters. See
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0022-call-batches.md.
+ */
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_ID: "blockchain.call_batch.id";
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_SENDER: "blockchain.call_batch.sender";
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_CALL_COUNT: "blockchain.call_batch.call_count";
+/** The outcome of a batch from chain data: `success`, `reverted` or `partially_reverted`. */
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_STATUS: "blockchain.call_batch.status";
+/** The EIP-5792 status code of the batch as the wallet reported it, e.g. 200 confirmed or 500 reverted; spans only. */
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_STATUS_CODE: "blockchain.call_batch.status_code";
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_ATOMIC: "blockchain.call_batch.atomic";
+/** Hashes of the transactions whose receipts the wallet reported for the batch. */
+export declare const ATTR_BLOCKCHAIN_CALL_BATCH_TRANSACTION_HASHES: "blockchain.call_batch.transaction_hashes";
 /**
  * Metrics only: what a send, confirmation or fee sample is about. Recorded as `user_operation` on samples of user
- * operations, and absent on those of transactions.
+ * operations and `call_batch` on those of call batches, and absent on those of transactions.
  */
 export declare const ATTR_BLOCKCHAIN_OPERATION_SUBJECT: "blockchain.operation.subject";
 /** Values for {@link ATTR_BLOCKCHAIN_OPERATION_SUBJECT}. */
 export declare const BLOCKCHAIN_OPERATION_SUBJECT_VALUE_USER_OPERATION: "user_operation";
+export declare const BLOCKCHAIN_OPERATION_SUBJECT_VALUE_CALL_BATCH: "call_batch";
+/** Values for {@link ATTR_BLOCKCHAIN_CALL_BATCH_STATUS}. */
+export declare const BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_SUCCESS: "success";
+export declare const BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_REVERTED: "reverted";
+export declare const BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_PARTIALLY_REVERTED: "partially_reverted";
 /** Values for {@link ATTR_BLOCKCHAIN_SYSTEM}. */
 export declare const BLOCKCHAIN_SYSTEM_VALUE_EVM: "evm";
 /** Values for {@link ATTR_BLOCKCHAIN_OPERATION_NAME}. */
@@ -497,7 +630,7 @@ export declare const BLOCKCHAIN_TX_STATUS_VALUE_REVERTED: "reverted";
 /**
  * @deprecated No longer recorded: a confirm span that gave up waiting records `error.type` `timeout` and no
  * `blockchain.tx.status`. The constant is removed in 1.0. See
- * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0016-timeout-is-an-observer-outcome.md.
+ * https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0016-timeout-is-an-observer-outcome.md.
  */
 export declare const BLOCKCHAIN_TX_STATUS_VALUE_TIMEOUT: "timeout";
 export declare const BLOCKCHAIN_TX_STATUS_VALUE_REPLACED: "replaced";
@@ -531,12 +664,12 @@ export declare const METRIC_BLOCKCHAIN_CLIENT_FEE: "blockchain.client.fee";
 /**
  * Records transactions, payments and user operations as spans. Obtain one from {@link createTxTracker}: it is not meant to be
  * implemented, and members may be added to it and to its handles in minor releases
- * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0014-core-api-boundary.md).
+ * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0014-core-api-boundary.md).
  */
 interface TxTracker {
   /**
    * Starts a `send` span as a child of `parent` (default: the active context).
-   * Call `end(hash)` once the transaction hash is known, or `fail(error)`.
+   * Call `end({ hash })` once the transaction hash is known, or `fail(error)`.
    */
   startSend(input: SendInput, parent?: Context): SendHandle;
   /**
@@ -549,14 +682,14 @@ interface TxTracker {
   /**
    * Starts a `payment` span as a child of `parent` (default: the active context), for a payment that another party
    * settles on chain
-   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0013-x402-payments.md). Call
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0013-x402-payments.md). Call
    * `end(settlement)` with the settlement, or `fail(error)`. A settlement with a hash links the transaction's confirm
    * span to this span, as a send span would.
    */
   startPayment(input: PaymentInput, parent?: Context): PaymentHandle;
   /**
    * Starts a `send` span for a user operation of a smart account as a child of `parent` (default: the active context)
-   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/adr/0021-user-operations.md). Call
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0021-user-operations.md). Call
    * `end({ userOpHash })` once the bundler returned the operation's hash, or `fail(error)`.
    */
   startUserOperationSend(input: UserOperationInput, parent?: Context): UserOperationSendHandle;
@@ -567,10 +700,23 @@ interface TxTracker {
    * returned handle must be ended.
    */
   startUserOperationConfirm(input: UserOperationConfirmInput, parent?: Context): UserOperationConfirmHandle;
+  /**
+   * Starts a `send` span for an EIP-5792 call batch as a child of `parent` (default: the active context)
+   * (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/adr/0022-call-batches.md). Call
+   * `end({ id })` once the wallet returned the batch id, or `fail(error)`.
+   */
+  startCallBatchSend(input: CallBatchInput, parent?: Context): CallBatchSendHandle;
+  /**
+   * Joins the `confirm` span of a call batch, starting it for the first caller; linked to its `send` span when
+   * known. As for {@link TxTracker.startConfirm}, calls for the same chain id and batch id share one span, apart from
+   * those of transactions and user operations. Returns a no-op handle for a batch that recently got its status. Every
+   * returned handle must be ended.
+   */
+  startCallBatchConfirm(input: CallBatchConfirmInput, parent?: Context): CallBatchConfirmHandle;
 }
 /**
  * Creates a tracker that records transactions as `send` and `confirm` spans, and payments as `payment` spans, with
- * `@opentelemetry/api` (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.8.0/docs/semconv.md). It makes
+ * `@opentelemetry/api` (https://github.com/selimaytac/hashspan/blob/@hashspan/core@0.9.0/docs/semconv.md). It makes
  * no network calls; the caller passes hashes and receipts. Its methods and handles never throw: failures are logged
  * via `diag`, and a method that fails returns a handle that records nothing.
  */
@@ -579,4 +725,4 @@ export declare function createTxTracker(options?: TxTrackerOptions): TxTracker;
 //#region src/version.d.ts
 export declare const VERSION: string;
 //#endregion
-export type { AddressMode, AddressOptions, AgentIdentity, ConfirmHandle, ConfirmInput, EndOptions, ErrorMessageMode, FailOptions, PaymentHandle, PaymentInput, PaymentResourceMode, PaymentSettlement, PaymentStatus, ReceiptLike, ReplacementReason, SendHandle, SendInput, SendResult, TxTracker, TxTrackerOptions, UserOperationConfirmHandle, UserOperationConfirmInput, UserOperationInput, UserOperationReceiptLike, UserOperationResult, UserOperationSendHandle, X402PaymentDetails };
+export type { AddressMode, AddressOptions, AgentIdentity, AuthorizationInput, CallBatchConfirmHandle, CallBatchConfirmInput, CallBatchInput, CallBatchResult, CallBatchSendHandle, CallBatchStatusLike, ConfirmHandle, ConfirmInput, EndOptions, ErrorMessageMode, FailOptions, PaymentHandle, PaymentInput, PaymentResourceMode, PaymentSettlement, PaymentStatus, ReceiptLike, ReplacementReason, SendHandle, SendInput, SendResult, TxTracker, TxTrackerOptions, UserOperationConfirmHandle, UserOperationConfirmInput, UserOperationInput, UserOperationReceiptLike, UserOperationResult, UserOperationSendHandle, X402PaymentDetails };