@hashspan/core 0.8.0 → 0.9.0

package/dist/index.mjs

@@ -5,7 +5,7 @@ const ATTR_GEN_AI_AGENT_NAME = "gen_ai.agent.name";
 /**
 * Agent identity as GenAI attributes. A field set in the static identity always wins; Baggage, which a remote caller
 * can set, only fills fields it leaves unset, and is not read at all with `fromBaggage` 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).
 */
 function agentAttributes(ctx, identity, fromBaggage = true) {
 	const baggage = fromBaggage ? propagation.getBaggage(ctx) : void 0;
@@ -21,7 +21,7 @@ function agentAttributes(ctx, identity, fromBaggage = true) {
 /**
 * 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.
 */
 const ATTR_BLOCKCHAIN_SYSTEM = "blockchain.system";
@@ -32,6 +32,12 @@ const ATTR_BLOCKCHAIN_TX_FROM = "blockchain.tx.from";
 const ATTR_BLOCKCHAIN_TX_TO = "blockchain.tx.to";
 const ATTR_BLOCKCHAIN_TX_VALUE = "blockchain.tx.value";
 const ATTR_BLOCKCHAIN_TX_NONCE = "blockchain.tx.nonce";
+/** Number of EIP-7702 authorizations a type 4 transaction carries. */
+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. */
+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. */
+const ATTR_BLOCKCHAIN_TX_AUTHORIZATION_CHAIN_IDS = "blockchain.tx.authorization.chain_ids";
 const ATTR_BLOCKCHAIN_TX_STATUS = "blockchain.tx.status";
 const ATTR_BLOCKCHAIN_TX_GAS_USED = "blockchain.tx.gas.used";
 const ATTR_BLOCKCHAIN_TX_EFFECTIVE_GAS_PRICE = "blockchain.tx.effective_gas_price";
@@ -45,12 +51,12 @@ const ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_NAME = "blockchain.contract.function.nam
 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.
 */
 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.
 */
 const ATTR_BLOCKCHAIN_PAYMENT_PROTOCOL = "blockchain.payment.protocol";
 const ATTR_BLOCKCHAIN_PAYMENT_PAYER = "blockchain.payment.payer";
@@ -63,7 +69,7 @@ const ATTR_BLOCKCHAIN_PAYMENT_SETTLED_AMOUNT = "blockchain.payment.settled_amoun
 /**
 * 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.
 */
 const ATTR_BLOCKCHAIN_PAYMENT_VERIFIED = "blockchain.payment.verified";
 /** x402's own payment fields. */
@@ -71,7 +77,7 @@ const ATTR_X402_SCHEME = "x402.scheme";
 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.
 */
 const ATTR_BLOCKCHAIN_USER_OPERATION_HASH = "blockchain.user_operation.hash";
 const ATTR_BLOCKCHAIN_USER_OPERATION_SENDER = "blockchain.user_operation.sender";
@@ -84,12 +90,31 @@ const ATTR_BLOCKCHAIN_USER_OPERATION_GAS_USED = "blockchain.user_operation.gas.u
 const ATTR_BLOCKCHAIN_USER_OPERATION_GAS_COST = "blockchain.user_operation.gas.cost";
 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.
+*/
+const ATTR_BLOCKCHAIN_CALL_BATCH_ID = "blockchain.call_batch.id";
+const ATTR_BLOCKCHAIN_CALL_BATCH_SENDER = "blockchain.call_batch.sender";
+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`. */
+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. */
+const ATTR_BLOCKCHAIN_CALL_BATCH_STATUS_CODE = "blockchain.call_batch.status_code";
+const ATTR_BLOCKCHAIN_CALL_BATCH_ATOMIC = "blockchain.call_batch.atomic";
+/** Hashes of the transactions whose receipts the wallet reported for the batch. */
+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.
 */
 const ATTR_BLOCKCHAIN_OPERATION_SUBJECT = "blockchain.operation.subject";
 /** Values for {@link ATTR_BLOCKCHAIN_OPERATION_SUBJECT}. */
 const BLOCKCHAIN_OPERATION_SUBJECT_VALUE_USER_OPERATION = "user_operation";
+const BLOCKCHAIN_OPERATION_SUBJECT_VALUE_CALL_BATCH = "call_batch";
+/** Values for {@link ATTR_BLOCKCHAIN_CALL_BATCH_STATUS}. */
+const BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_SUCCESS = "success";
+const BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_REVERTED = "reverted";
+const BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_PARTIALLY_REVERTED = "partially_reverted";
 /** Values for {@link ATTR_BLOCKCHAIN_SYSTEM}. */
 const BLOCKCHAIN_SYSTEM_VALUE_EVM = "evm";
 /** Values for {@link ATTR_BLOCKCHAIN_OPERATION_NAME}. */
@@ -108,7 +133,7 @@ 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.
 */
 const BLOCKCHAIN_TX_STATUS_VALUE_TIMEOUT = "timeout";
 const BLOCKCHAIN_TX_STATUS_VALUE_REPLACED = "replaced";
@@ -331,7 +356,7 @@ function resolveAddressFormatter(option) {
 		hash: void 0
 	};
 	switch (mode) {
-		case "raw": return formatter((address) => address, false);
+		case "raw": return formatter((address) => address.toLowerCase(), false);
 		case "off": return OFF_ADDRESS_FORMATTER;
 		case "hashed": {
 			const hashFn = hash ?? defaultHash();
@@ -355,6 +380,8 @@ const ADDRESS_LENGTH = 42;
 */
 const MAX_HEX_LENGTH = 66;
 const MAX_MESSAGE_LENGTH = 256;
+/** A URL in free text: `scheme://` up to the next whitespace, quote or bracket; the bounded scheme keeps it linear. */
+const URL_IN_TEXT = /\b[A-Za-z][A-Za-z0-9+.-]{0,31}:\/\/[^\s"'<>()[\]{}]+/g;
 /**
 * Rewrites every address in `text` with the address mode (`<address>` when it records none). In `off` and `hashed`
 * mode, hex values longer than an address become `<hex>`, because they can embed one.
@@ -366,11 +393,12 @@ function formatAddressesIn(text, formatAddress) {
 	});
 }
 /**
-* First line of an error message with addresses per address mode and longer hex data (such as calldata)
-* replaced by `<hex>`. Best effort: other free text is kept, so the redaction hook still runs on the result.
+* First line of an error message with URLs cut to their origin (an RPC URL can carry an API key in its path or
+* query), addresses per address mode and longer hex data (such as calldata) replaced by `<hex>`. Best effort: other
+* free text is kept, so the redaction hook still runs on the result.
 */
 function sanitizeErrorMessage(message, formatAddress) {
-	const sanitized = formatAddressesIn(message.split("\n", 1)[0]?.trim() ?? "", formatAddress).replace(HEX, (hex) => hex.length > MAX_HEX_LENGTH ? "<hex>" : hex);
+	const sanitized = formatAddressesIn((message.split("\n", 1)[0]?.trim() ?? "").replace(URL_IN_TEXT, (url) => hidesUserInfo(url) ? "<url>" : originOf(url) ?? "<url>"), formatAddress).replace(HEX, (hex) => hex.length > MAX_HEX_LENGTH ? "<hex>" : hex);
 	return sanitized.length > MAX_MESSAGE_LENGTH ? `${sanitized.slice(0, MAX_MESSAGE_LENGTH)}...` : sanitized;
 }
 const MAX_ARGUMENTS_LENGTH = 4096;
@@ -473,7 +501,16 @@ function paymentResourceOf(resource, mode) {
 	if (mode === "off" || hidesUserInfo(resource)) return void 0;
 	const recorded = mode === "path" ? sanitizeResource(resource) : originOf(resource);
 	if (recorded === void 0) return void 0;
-	return recorded.length > MAX_RESOURCE_LENGTH ? `${recorded.slice(0, MAX_RESOURCE_LENGTH)}...` : recorded;
+	return cutAt(recorded, MAX_RESOURCE_LENGTH);
+}
+/**
+* `text` cut to `max` characters, followed by `...`. A hex value that the cut splits is dropped whole: the part left
+* is shorter than an address, so the address mode, applied later, would no longer recognise it as one.
+*/
+function cutAt(text, max) {
+	if (text.length <= max) return text;
+	const head = text.slice(0, max);
+	return `${/^[0-9a-fA-F]/.test(text.slice(max)) ? head.replace(/0[xX][0-9a-fA-F]*$/, "") : head}...`;
 }
 /** Longest `x402.resource` recorded; the value comes from the server that asks for the payment. */
 const MAX_RESOURCE_LENGTH = 512;
@@ -507,7 +544,7 @@ function sanitizeResource(resource) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "0.8.0";
+const VERSION = "0.9.0";
 //#endregion
 //#region src/tracker.ts
 const INSTRUMENTATION_NAME = "@hashspan/core";
@@ -532,12 +569,20 @@ const NON_SENSITIVE_KEYS = /* @__PURE__ */ new Set([
 	ATTR_BLOCKCHAIN_PAYMENT_VERIFIED,
 	ATTR_BLOCKCHAIN_USER_OPERATION_HASH,
 	ATTR_BLOCKCHAIN_USER_OPERATION_SUCCESS,
+	ATTR_BLOCKCHAIN_CALL_BATCH_ID,
+	ATTR_BLOCKCHAIN_CALL_BATCH_STATUS,
 	ATTR_ERROR_TYPE,
 	ATTR_EXCEPTION_TYPE
 ]);
 const TX_HASH = /^0x[0-9a-fA-F]{64}$/;
 const ADDRESS = /^0x[0-9a-fA-F]{40}$/;
 const ZERO_ADDRESS = /^0x0{40}$/;
+/** The value of an own data property of `target`; undefined for an accessor, so no getter of the caller runs. */
+function ownValue(target, key) {
+	if (typeof target !== "object" || target === null) return void 0;
+	const descriptor = Object.getOwnPropertyDescriptor(target, key);
+	return descriptor !== void 0 && "value" in descriptor ? descriptor.value : void 0;
+}
 /** A non-negative integer that fits in 256 bits. */
 const AMOUNT = /^(0|[1-9][0-9]{0,77})$/;
 /** A `0x` hex quantity of at most 256 bits, as JSON-RPC encodes integers. */
@@ -546,6 +591,18 @@ const MAX_UINT256 = 2n ** 256n - 1n;
 const MAX_SAFE_INTEGER = BigInt(Number.MAX_SAFE_INTEGER);
 /** `error.type` of a wait that gave up: a confirmation or a payment whose outcome was never learned. */
 const OBSERVER_TIMEOUT = "timeout";
+/** `error.type` of a call batch that failed without being included (EIP-5792 status 400). */
+const CALL_BATCH_FAILED = "failed";
+/** A call batch id: `0x`-prefixed hex of at most 8194 characters, the bound EIP-5792 sets. */
+const CALL_BATCH_ID = /^0x[0-9a-fA-F]{1,8192}$/;
+/** Longest call batch id recorded as an attribute. */
+const MAX_CALL_BATCH_ID_ATTRIBUTE_LENGTH = 256;
+/** Most transaction hashes recorded for one call batch. */
+const MAX_CALL_BATCH_TRANSACTION_HASHES = 64;
+/** Most EIP-7702 authorizations listed on a send span; the count covers all of them. */
+const MAX_AUTHORIZATIONS = 64;
+/** EIP-5792 status code of a batch that is still pending. */
+const CALL_BATCH_PENDING = 100;
 const PAYMENT_STATUSES = /* @__PURE__ */ new Set([
 	BLOCKCHAIN_PAYMENT_STATUS_VALUE_SETTLED,
 	BLOCKCHAIN_PAYMENT_STATUS_VALUE_PENDING,
@@ -583,6 +640,16 @@ const NOOP_USER_OPERATION_CONFIRM = {
 	timeout: () => {},
 	fail: () => {}
 };
+const noopCallBatchSend = (parent) => ({
+	context: parent,
+	end: () => {},
+	fail: () => {}
+});
+const NOOP_CALL_BATCH_CONFIRM = {
+	end: () => {},
+	timeout: () => {},
+	fail: () => {}
+};
 /** Runs `fn`, logging instead of throwing: instrumentation must never break the caller. */
 function safely(what, fn, fallback) {
 	try {
@@ -626,7 +693,6 @@ function amount(value) {
 	const text = typeof value === "bigint" ? value.toString() : value;
 	return typeof text === "string" && AMOUNT.test(text) ? text : void 0;
 }
-/** The `error.type` for a failure: an adapter's override when it is a short identifier, else the class name. */
 /** A finite number, an `HrTime` pair or a `Date`: what the deprecated positional `endTime` argument takes. */
 function isTimeInput(value) {
 	if (typeof value === "number") return Number.isFinite(value);
@@ -658,6 +724,7 @@ function handleOptions(second, third) {
 		return {};
 	}
 }
+/** The `error.type` for a failure: an adapter's override when it is a short identifier, else the class name. */
 function reportedErrorType(error, options) {
 	const override = options?.errorType;
 	if (override === void 0) return errorType(error);
@@ -665,6 +732,14 @@ function reportedErrorType(error, options) {
 	diag.debug("hashspan: ignoring an error type that is not a short identifier");
 	return errorType(error);
 }
+/** A call batch id the tracker keys and records. */
+function isCallBatchId(id) {
+	return typeof id === "string" && CALL_BATCH_ID.test(id);
+}
+/** Whether `status` says the batch is still pending: its wait resolved before an outcome. */
+function isPendingCallBatch(status) {
+	return status?.statusCode === CALL_BATCH_PENDING;
+}
 /**
 * Joins the confirm span for `hash` in `registry`, opening it with `open` for the first handle; undefined when the
 * key recently got a receipt. A receipt from any handle ends the span; a timeout or failure only ends it when it is the
@@ -703,7 +778,7 @@ function joinConfirm(registry, chainId, hash, open) {
 }
 /**
 * 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.
 */
@@ -727,6 +802,14 @@ function createTxTracker(options = {}) {
 		ttlMs: options.linkTtlMs ?? DEFAULT_LINK_TTL_MS,
 		maxEntries: options.maxTrackedTransactions ?? DEFAULT_MAX_TRACKED
 	});
+	const callBatchLinks = new LinkStore({
+		ttlMs: options.linkTtlMs ?? DEFAULT_LINK_TTL_MS,
+		maxEntries: options.maxTrackedTransactions ?? DEFAULT_MAX_TRACKED
+	});
+	const callBatchConfirmations = new ConfirmRegistry({
+		ttlMs: options.linkTtlMs ?? DEFAULT_LINK_TTL_MS,
+		maxEntries: options.maxTrackedTransactions ?? DEFAULT_MAX_TRACKED
+	});
 	const txMetrics = createTxMetrics(options.meterProvider, INSTRUMENTATION_NAME, VERSION);
 	/** Attributes of a metric: low-cardinality only, never an address, hash or agent identity. */
 	const metricAttributes = (chainId, extra = {}) => ({
@@ -739,6 +822,11 @@ function createTxTracker(options = {}) {
 		[ATTR_BLOCKCHAIN_OPERATION_SUBJECT]: BLOCKCHAIN_OPERATION_SUBJECT_VALUE_USER_OPERATION,
 		...extra
 	});
+	/** Metric attributes of a call batch sample. */
+	const callBatchMetricAttributes = (chainId, extra = {}) => metricAttributes(chainId, {
+		[ATTR_BLOCKCHAIN_OPERATION_SUBJECT]: BLOCKCHAIN_OPERATION_SUBJECT_VALUE_CALL_BATCH,
+		...extra
+	});
 	const secondsSince = (startMs, endTime) => (toEpochMs(endTime) - startMs) / 1e3;
 	let tracer;
 	const getTracer = () => {
@@ -764,7 +852,7 @@ function createTxTracker(options = {}) {
 	/**
 	* Exception event attributes for `error`, per the error message mode. The error object itself is never handed to
 	* the SDK: its message and stack can carry addresses and calldata
-	* (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).
 	*/
 	const exceptionAttributes = (type, error) => {
 		const attributes = { [ATTR_EXCEPTION_TYPE]: type };
@@ -819,6 +907,28 @@ function createTxTracker(options = {}) {
 		const formatted = formatAddress(address);
 		if (formatted !== void 0) attributes[key] = formatted;
 	};
+	/**
+	* Records an EIP-7702 authorization list: its length, and for each well-formed entry (an address and a non-negative
+	* integer chain id, read from own data properties only) its address per the address mode and its chain id, at most
+	* {@link MAX_AUTHORIZATIONS}. The two lists stay aligned: an entry is listed in both or in neither.
+	*/
+	const setAuthorizations = (attributes, list) => {
+		if (!Array.isArray(list) || list.length === 0) return;
+		attributes[ATTR_BLOCKCHAIN_TX_AUTHORIZATION_COUNT] = list.length;
+		const addresses = [];
+		const chainIds = [];
+		for (const entry of list.slice(0, MAX_AUTHORIZATIONS)) {
+			const address = ownValue(entry, "address");
+			const chainId = ownValue(entry, "chainId");
+			if (typeof address !== "string" || !ADDRESS.test(address)) continue;
+			if (typeof chainId !== "number" || !Number.isSafeInteger(chainId) || chainId < 0) continue;
+			const formatted = formatAddress(address);
+			if (formatted !== void 0) addresses.push(formatted);
+			chainIds.push(chainId);
+		}
+		if (addresses.length > 0) attributes[ATTR_BLOCKCHAIN_TX_AUTHORIZATION_ADDRESSES] = addresses;
+		if (chainIds.length > 0) attributes[ATTR_BLOCKCHAIN_TX_AUTHORIZATION_CHAIN_IDS] = chainIds;
+	};
 	/** Records `address` only if it is one: payment and user operation addresses come from remote parties. */
 	const setRemoteAddress = (attributes, key, address) => {
 		if (typeof address === "string" && ADDRESS.test(address)) setAddress(attributes, key, address);
@@ -836,6 +946,11 @@ function createTxTracker(options = {}) {
 		setAddress(attributes, ATTR_BLOCKCHAIN_TX_TO, input.to);
 		if (input.value !== void 0) attributes[ATTR_BLOCKCHAIN_TX_VALUE] = input.value.toString();
 		if (input.nonce !== void 0) attributes[ATTR_BLOCKCHAIN_TX_NONCE] = input.nonce;
+		try {
+			setAuthorizations(attributes, input.authorizations);
+		} catch (error) {
+			diag.debug(`hashspan: could not record authorizations (${errorType(error)})`);
+		}
 		if (input.functionName !== void 0) attributes[ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_NAME] = input.functionName;
 		if (input.functionSelector !== void 0) attributes[ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_SELECTOR] = input.functionSelector;
 		if (options.recordFunctionArguments === true && input.functionArguments !== void 0) try {
@@ -956,7 +1071,7 @@ function createTxTracker(options = {}) {
 	};
 	/**
 	* Ends `shared` with `receipt`, attributing it to the transaction that was mined
-	* (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).
 	*/
 	const endWithReceipt = (chainId, hash, shared, receipt, endTime) => {
 		const mined = receipt.transactionHash;
@@ -1192,13 +1307,170 @@ function createTxTracker(options = {}) {
 			}
 		};
 	};
+	const startCallBatchSend = (input, parentCtx) => {
+		const parent = parentCtx ?? context.active();
+		const { chainId } = input;
+		const attributes = baseAttributes(chainId, BLOCKCHAIN_OPERATION_NAME_VALUE_SEND, parent);
+		setRemoteAddress(attributes, ATTR_BLOCKCHAIN_CALL_BATCH_SENDER, input.sender);
+		const callCount = smallQuantity(input.callCount);
+		if (callCount !== void 0) attributes[ATTR_BLOCKCHAIN_CALL_BATCH_CALL_COUNT] = callCount;
+		const span = getTracer().startSpan(`send ${chainId}`, {
+			kind: SpanKind.CLIENT,
+			attributes: redact(attributes),
+			...input.startTime !== void 0 ? { startTime: input.startTime } : {}
+		}, parent);
+		const finish = finisher(span);
+		const startMs = toEpochMs(input.startTime);
+		const recordSend = (endTime, errorType) => txMetrics.sendDuration(secondsSince(startMs, endTime), callBatchMetricAttributes(chainId, errorType === void 0 ? {} : { [ATTR_ERROR_TYPE]: errorType }));
+		return {
+			context: trace.setSpan(parent, span),
+			end: (result, second) => {
+				const { endTime } = handleOptions(second);
+				finish("record call batch id", () => {
+					const id = result?.id;
+					if (!isCallBatchId(id)) {
+						diag.debug("hashspan: ending a send span without a valid call batch id");
+						return;
+					}
+					const sent = {
+						spanContext: span.spanContext(),
+						parent
+					};
+					callBatchLinks.set(chainId, id, sent);
+					const hashes = result.transactionHashes;
+					if (Array.isArray(hashes)) {
+						for (const hash of hashes) if (typeof hash === "string" && TX_HASH.test(hash) && !/^0x0+$/.test(hash)) links.set(chainId, hash, sent);
+					}
+					span.setAttributes(redact({ [ATTR_BLOCKCHAIN_CALL_BATCH_ID]: id.slice(0, MAX_CALL_BATCH_ID_ATTRIBUTE_LENGTH) }));
+					recordSend(endTime);
+				}, endTime);
+			},
+			fail: (error, second) => {
+				const read = handleOptions(second);
+				finish("record call batch send failure", () => recordSend(read.endTime, markError(span, reportedErrorType(error, read), error, errorType(error))), read.endTime);
+			}
+		};
+	};
+	/** Attributes of a call batch status. Its values come from a wallet: what is malformed is left out. */
+	const callBatchStatusAttributes = (status) => {
+		const attributes = {};
+		const code = smallQuantity(status.statusCode);
+		if (code !== void 0) attributes[ATTR_BLOCKCHAIN_CALL_BATCH_STATUS_CODE] = code;
+		const atomic = status.atomic;
+		if (typeof atomic === "boolean") attributes[ATTR_BLOCKCHAIN_CALL_BATCH_ATOMIC] = atomic;
+		const receipts = status.receipts;
+		if (Array.isArray(receipts)) {
+			const hashes = [];
+			const seen = /* @__PURE__ */ new Set();
+			let block;
+			for (const receipt of receipts) {
+				const hash = receipt?.transactionHash;
+				if (typeof hash === "string" && TX_HASH.test(hash) && !seen.has(hash.toLowerCase()) && hashes.length < MAX_CALL_BATCH_TRANSACTION_HASHES) {
+					seen.add(hash.toLowerCase());
+					hashes.push(hash);
+				}
+				const number = smallQuantity(receipt?.blockNumber);
+				if (number !== void 0 && (block === void 0 || number > block)) block = number;
+			}
+			if (hashes.length > 0) attributes[ATTR_BLOCKCHAIN_CALL_BATCH_TRANSACTION_HASHES] = hashes;
+			if (block !== void 0) attributes[ATTR_BLOCKCHAIN_BLOCK_NUMBER] = block;
+		}
+		return attributes;
+	};
+	/**
+	* The outcome of an EIP-5792 status code (ADR 0022): `blockchain.call_batch.status` for outcomes from chain data,
+	* `error.type` for the rest; a code the spec does not define, or none, is `_OTHER`.
+	*/
+	const callBatchOutcome = (code) => {
+		switch (code) {
+			case 200: return { status: BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_SUCCESS };
+			case 400: return { errorType: CALL_BATCH_FAILED };
+			case 500: return {
+				status: BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_REVERTED,
+				errorType: BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_REVERTED
+			};
+			case 600: return {
+				status: BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_PARTIALLY_REVERTED,
+				errorType: BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_PARTIALLY_REVERTED
+			};
+			default: return { errorType: ERROR_TYPE_VALUE_OTHER };
+		}
+	};
+	/** Opens the confirm span of a call batch. */
+	const openCallBatchConfirm = (input, parentCtx) => {
+		const { chainId, id } = input;
+		const sent = callBatchLinks.get(chainId, id);
+		const active = context.active();
+		const parent = parentCtx ?? (trace.getSpan(active) ? active : sent?.parent ?? active);
+		const attributes = baseAttributes(chainId, BLOCKCHAIN_OPERATION_NAME_VALUE_CONFIRM, parent);
+		attributes[ATTR_BLOCKCHAIN_CALL_BATCH_ID] = id.slice(0, MAX_CALL_BATCH_ID_ATTRIBUTE_LENGTH);
+		const span = getTracer().startSpan(`confirm ${chainId}`, {
+			kind: SpanKind.CLIENT,
+			attributes: redact(attributes),
+			links: sent ? [{ context: sent.spanContext }] : [],
+			...input.startTime !== void 0 ? { startTime: input.startTime } : {}
+		}, parent);
+		const finish = finisher(span);
+		const startMs = toEpochMs(input.startTime);
+		const recordConfirmation = (endTime, outcome) => txMetrics.confirmationDuration(secondsSince(startMs, endTime), callBatchMetricAttributes(chainId, outcome));
+		return {
+			active: 0,
+			ended: false,
+			status: (status, endTime) => finish("record call batch status", () => {
+				const attributes = callBatchStatusAttributes(status ?? {});
+				if (isPendingCallBatch(status)) {
+					span.setAttributes(redact(attributes));
+					return;
+				}
+				const outcome = callBatchOutcome(status?.statusCode);
+				if (outcome.status !== void 0) attributes[ATTR_BLOCKCHAIN_CALL_BATCH_STATUS] = outcome.status;
+				span.setAttributes(redact(attributes));
+				if (outcome.errorType !== void 0) markError(span, outcome.errorType);
+				recordConfirmation(endTime, outcome.status !== void 0 ? { [ATTR_BLOCKCHAIN_CALL_BATCH_STATUS]: outcome.status } : { [ATTR_ERROR_TYPE]: outcome.errorType });
+			}, endTime),
+			timeout: (endTime) => finish("record call batch confirmation timeout", () => recordConfirmation(endTime, { [ATTR_ERROR_TYPE]: markError(span, OBSERVER_TIMEOUT) }), endTime),
+			fail: (error, read) => finish("record call batch confirmation failure", () => recordConfirmation(read.endTime, { [ATTR_ERROR_TYPE]: markError(span, reportedErrorType(error, read), error, errorType(error)) }), read.endTime)
+		};
+	};
+	const startCallBatchConfirm = (input, parentCtx) => {
+		const { chainId, id } = input;
+		if (!isCallBatchId(id)) {
+			diag.debug("hashspan: not confirming a call batch without a valid id");
+			return NOOP_CALL_BATCH_CONFIRM;
+		}
+		const claim = joinConfirm(callBatchConfirmations, chainId, id, () => openCallBatchConfirm(input, parentCtx));
+		if (!claim) return NOOP_CALL_BATCH_CONFIRM;
+		const { shared } = claim;
+		return {
+			end: (status, second) => {
+				const { endTime } = handleOptions(second);
+				if (isPendingCallBatch(status)) {
+					claim.withdraw(() => shared.status(status, endTime));
+					return;
+				}
+				if (!claim.receive()) return;
+				callBatchConfirmations.settle(chainId, id, shared);
+				shared.status(status, endTime);
+			},
+			timeout: (second) => {
+				const { endTime } = handleOptions(second);
+				claim.withdraw(() => shared.timeout(endTime));
+			},
+			fail: (error, second) => {
+				const read = handleOptions(second);
+				claim.withdraw(() => shared.fail(error, read));
+			}
+		};
+	};
 	return {
 		startSend: (input, parent) => safely("start send span", () => startSend(input, parent), noopSend(parent ?? context.active())),
 		startConfirm: (input, parent) => safely("start confirm span", () => startConfirm(input, parent), NOOP_CONFIRM),
 		startPayment: (input, parent) => safely("start payment span", () => startPayment(input, parent), NOOP_PAYMENT),
 		startUserOperationSend: (input, parent) => safely("start user operation send span", () => startUserOperationSend(input, parent), noopUserOperationSend(parent ?? context.active())),
-		startUserOperationConfirm: (input, parent) => safely("start user operation confirm span", () => startUserOperationConfirm(input, parent), NOOP_USER_OPERATION_CONFIRM)
+		startUserOperationConfirm: (input, parent) => safely("start user operation confirm span", () => startUserOperationConfirm(input, parent), NOOP_USER_OPERATION_CONFIRM),
+		startCallBatchSend: (input, parent) => safely("start call batch send span", () => startCallBatchSend(input, parent), noopCallBatchSend(parent ?? context.active())),
+		startCallBatchConfirm: (input, parent) => safely("start call batch confirm span", () => startCallBatchConfirm(input, parent), NOOP_CALL_BATCH_CONFIRM)
 	};
 }
 //#endregion
-export { ATTR_BLOCKCHAIN_BLOCK_NUMBER, ATTR_BLOCKCHAIN_CHAIN_ID, ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_ARGUMENTS, ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_NAME, ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_SELECTOR, ATTR_BLOCKCHAIN_OPERATION_NAME, ATTR_BLOCKCHAIN_OPERATION_SUBJECT, ATTR_BLOCKCHAIN_PAYMENT_AMOUNT, ATTR_BLOCKCHAIN_PAYMENT_ASSET, ATTR_BLOCKCHAIN_PAYMENT_PAYER, ATTR_BLOCKCHAIN_PAYMENT_PROTOCOL, ATTR_BLOCKCHAIN_PAYMENT_RECIPIENT, ATTR_BLOCKCHAIN_PAYMENT_SETTLED_AMOUNT, ATTR_BLOCKCHAIN_PAYMENT_STATUS, ATTR_BLOCKCHAIN_PAYMENT_VERIFIED, ATTR_BLOCKCHAIN_SYSTEM, ATTR_BLOCKCHAIN_TX_EFFECTIVE_GAS_PRICE, ATTR_BLOCKCHAIN_TX_FEE, ATTR_BLOCKCHAIN_TX_FROM, ATTR_BLOCKCHAIN_TX_GAS_USED, ATTR_BLOCKCHAIN_TX_HASH, ATTR_BLOCKCHAIN_TX_L1_FEE, ATTR_BLOCKCHAIN_TX_NONCE, ATTR_BLOCKCHAIN_TX_REPLACEMENT_HASH, ATTR_BLOCKCHAIN_TX_REPLACEMENT_REASON, ATTR_BLOCKCHAIN_TX_REVERT_REASON, ATTR_BLOCKCHAIN_TX_STATUS, ATTR_BLOCKCHAIN_TX_TO, ATTR_BLOCKCHAIN_TX_VALUE, ATTR_BLOCKCHAIN_USER_OPERATION_CALL_COUNT, ATTR_BLOCKCHAIN_USER_OPERATION_ENTRY_POINT, ATTR_BLOCKCHAIN_USER_OPERATION_GAS_COST, ATTR_BLOCKCHAIN_USER_OPERATION_GAS_USED, ATTR_BLOCKCHAIN_USER_OPERATION_HASH, ATTR_BLOCKCHAIN_USER_OPERATION_NONCE, ATTR_BLOCKCHAIN_USER_OPERATION_PAYMASTER, ATTR_BLOCKCHAIN_USER_OPERATION_SENDER, ATTR_BLOCKCHAIN_USER_OPERATION_SUCCESS, ATTR_ERROR_TYPE, ATTR_GEN_AI_AGENT_ID, ATTR_GEN_AI_AGENT_NAME, ATTR_X402_RESOURCE, ATTR_X402_SCHEME, BLOCKCHAIN_OPERATION_NAME_VALUE_CONFIRM, BLOCKCHAIN_OPERATION_NAME_VALUE_PAYMENT, BLOCKCHAIN_OPERATION_NAME_VALUE_SEND, BLOCKCHAIN_OPERATION_SUBJECT_VALUE_USER_OPERATION, BLOCKCHAIN_PAYMENT_PROTOCOL_VALUE_X402, BLOCKCHAIN_PAYMENT_STATUS_VALUE_FAILED, BLOCKCHAIN_PAYMENT_STATUS_VALUE_PENDING, BLOCKCHAIN_PAYMENT_STATUS_VALUE_SETTLED, BLOCKCHAIN_SYSTEM_VALUE_EVM, BLOCKCHAIN_TX_REPLACEMENT_REASON_VALUE_CANCELLED, BLOCKCHAIN_TX_REPLACEMENT_REASON_VALUE_REPLACED, BLOCKCHAIN_TX_REPLACEMENT_REASON_VALUE_REPRICED, BLOCKCHAIN_TX_STATUS_VALUE_REPLACED, BLOCKCHAIN_TX_STATUS_VALUE_REVERTED, BLOCKCHAIN_TX_STATUS_VALUE_SUCCESS, BLOCKCHAIN_TX_STATUS_VALUE_TIMEOUT, ERROR_TYPE_VALUE_OTHER, METRIC_BLOCKCHAIN_CLIENT_CONFIRMATION_DURATION, METRIC_BLOCKCHAIN_CLIENT_FEE, METRIC_BLOCKCHAIN_CLIENT_SEND_DURATION, VERSION, createTxTracker };
+export { ATTR_BLOCKCHAIN_BLOCK_NUMBER, ATTR_BLOCKCHAIN_CALL_BATCH_ATOMIC, ATTR_BLOCKCHAIN_CALL_BATCH_CALL_COUNT, ATTR_BLOCKCHAIN_CALL_BATCH_ID, ATTR_BLOCKCHAIN_CALL_BATCH_SENDER, ATTR_BLOCKCHAIN_CALL_BATCH_STATUS, ATTR_BLOCKCHAIN_CALL_BATCH_STATUS_CODE, ATTR_BLOCKCHAIN_CALL_BATCH_TRANSACTION_HASHES, ATTR_BLOCKCHAIN_CHAIN_ID, ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_ARGUMENTS, ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_NAME, ATTR_BLOCKCHAIN_CONTRACT_FUNCTION_SELECTOR, ATTR_BLOCKCHAIN_OPERATION_NAME, ATTR_BLOCKCHAIN_OPERATION_SUBJECT, ATTR_BLOCKCHAIN_PAYMENT_AMOUNT, ATTR_BLOCKCHAIN_PAYMENT_ASSET, ATTR_BLOCKCHAIN_PAYMENT_PAYER, ATTR_BLOCKCHAIN_PAYMENT_PROTOCOL, ATTR_BLOCKCHAIN_PAYMENT_RECIPIENT, ATTR_BLOCKCHAIN_PAYMENT_SETTLED_AMOUNT, ATTR_BLOCKCHAIN_PAYMENT_STATUS, ATTR_BLOCKCHAIN_PAYMENT_VERIFIED, ATTR_BLOCKCHAIN_SYSTEM, ATTR_BLOCKCHAIN_TX_AUTHORIZATION_ADDRESSES, ATTR_BLOCKCHAIN_TX_AUTHORIZATION_CHAIN_IDS, ATTR_BLOCKCHAIN_TX_AUTHORIZATION_COUNT, ATTR_BLOCKCHAIN_TX_EFFECTIVE_GAS_PRICE, ATTR_BLOCKCHAIN_TX_FEE, ATTR_BLOCKCHAIN_TX_FROM, ATTR_BLOCKCHAIN_TX_GAS_USED, ATTR_BLOCKCHAIN_TX_HASH, ATTR_BLOCKCHAIN_TX_L1_FEE, ATTR_BLOCKCHAIN_TX_NONCE, ATTR_BLOCKCHAIN_TX_REPLACEMENT_HASH, ATTR_BLOCKCHAIN_TX_REPLACEMENT_REASON, ATTR_BLOCKCHAIN_TX_REVERT_REASON, ATTR_BLOCKCHAIN_TX_STATUS, ATTR_BLOCKCHAIN_TX_TO, ATTR_BLOCKCHAIN_TX_VALUE, ATTR_BLOCKCHAIN_USER_OPERATION_CALL_COUNT, ATTR_BLOCKCHAIN_USER_OPERATION_ENTRY_POINT, ATTR_BLOCKCHAIN_USER_OPERATION_GAS_COST, ATTR_BLOCKCHAIN_USER_OPERATION_GAS_USED, ATTR_BLOCKCHAIN_USER_OPERATION_HASH, ATTR_BLOCKCHAIN_USER_OPERATION_NONCE, ATTR_BLOCKCHAIN_USER_OPERATION_PAYMASTER, ATTR_BLOCKCHAIN_USER_OPERATION_SENDER, ATTR_BLOCKCHAIN_USER_OPERATION_SUCCESS, ATTR_ERROR_TYPE, ATTR_GEN_AI_AGENT_ID, ATTR_GEN_AI_AGENT_NAME, ATTR_X402_RESOURCE, ATTR_X402_SCHEME, BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_PARTIALLY_REVERTED, BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_REVERTED, BLOCKCHAIN_CALL_BATCH_STATUS_VALUE_SUCCESS, BLOCKCHAIN_OPERATION_NAME_VALUE_CONFIRM, BLOCKCHAIN_OPERATION_NAME_VALUE_PAYMENT, BLOCKCHAIN_OPERATION_NAME_VALUE_SEND, BLOCKCHAIN_OPERATION_SUBJECT_VALUE_CALL_BATCH, BLOCKCHAIN_OPERATION_SUBJECT_VALUE_USER_OPERATION, BLOCKCHAIN_PAYMENT_PROTOCOL_VALUE_X402, BLOCKCHAIN_PAYMENT_STATUS_VALUE_FAILED, BLOCKCHAIN_PAYMENT_STATUS_VALUE_PENDING, BLOCKCHAIN_PAYMENT_STATUS_VALUE_SETTLED, BLOCKCHAIN_SYSTEM_VALUE_EVM, BLOCKCHAIN_TX_REPLACEMENT_REASON_VALUE_CANCELLED, BLOCKCHAIN_TX_REPLACEMENT_REASON_VALUE_REPLACED, BLOCKCHAIN_TX_REPLACEMENT_REASON_VALUE_REPRICED, BLOCKCHAIN_TX_STATUS_VALUE_REPLACED, BLOCKCHAIN_TX_STATUS_VALUE_REVERTED, BLOCKCHAIN_TX_STATUS_VALUE_SUCCESS, BLOCKCHAIN_TX_STATUS_VALUE_TIMEOUT, ERROR_TYPE_VALUE_OTHER, METRIC_BLOCKCHAIN_CLIENT_CONFIRMATION_DURATION, METRIC_BLOCKCHAIN_CLIENT_FEE, METRIC_BLOCKCHAIN_CLIENT_SEND_DURATION, VERSION, createTxTracker };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@hashspan/core",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Transaction lifecycle tracing for on-chain actions of AI agents, built on OpenTelemetry.",
   "license": "Apache-2.0",
   "author": "Selim Aytac",
-  "homepage": "https://github.com/selimaytac/hashspan/tree/main/packages/core#readme",
+  "homepage": "https://hashspan.dev",
   "bugs": {
     "url": "https://github.com/selimaytac/hashspan/issues"
   },