@tari-project/ootle-ts-bindings 1.50.0 → 1.52.0

package/dist/helpers/helpers.js

@@ -58,6 +58,10 @@ export function shortenSubstateId(substateId, start = 4, end = 4) {
     return parts[0] + "_" + shortenString(parts[1], start, end);
 }
 export function shortenString(string, start = 8, end = 8) {
+    // The number 3 is from the characters for ellipsis
+    if (string.length < start + end + 3) {
+        return string;
+    }
     return string.substring(0, start) + "..." + string.slice(-end);
 }
 export function rejectReasonToString(reason) {

package/dist/index.d.ts

@@ -55,7 +55,6 @@ export * from "./types/EntityId";
 export * from "./types/Epoch";
 export * from "./types/Era";
 export * from "./types/Event";
-export * from "./types/EvictNodeAtom";
 export * from "./types/EvidenceInputLockData";
 export * from "./types/Evidence";
 export * from "./types/ExecuteResult";

package/dist/index.js

@@ -57,7 +57,6 @@ export * from "./types/EntityId";
 export * from "./types/Epoch";
 export * from "./types/Era";
 export * from "./types/Event";
-export * from "./types/EvictNodeAtom";
 export * from "./types/EvidenceInputLockData";
 export * from "./types/Evidence";
 export * from "./types/ExecuteResult";

package/dist/tari-indexer-client.d.ts

@@ -9,6 +9,7 @@ export * from "./types/tari-indexer-client/ValidatorConsensusState";
 export * from "./types/tari-indexer-client/StreamTransactionEventsRequest";
 export * from "./types/tari-indexer-client/QueryTransactionEventsRequest";
 export * from "./types/tari-indexer-client/TransactionEntry";
+export * from "./types/tari-indexer-client/TransactionSource";
 export * from "./types/tari-indexer-client/InspectSubstateRequest";
 export * from "./types/tari-indexer-client/ListSubstateItem";
 export * from "./types/tari-indexer-client/IndexerTransactionFinalizedResult";

package/dist/tari-indexer-client.js

@@ -11,6 +11,7 @@ export * from "./types/tari-indexer-client/ValidatorConsensusState";
 export * from "./types/tari-indexer-client/StreamTransactionEventsRequest";
 export * from "./types/tari-indexer-client/QueryTransactionEventsRequest";
 export * from "./types/tari-indexer-client/TransactionEntry";
+export * from "./types/tari-indexer-client/TransactionSource";
 export * from "./types/tari-indexer-client/InspectSubstateRequest";
 export * from "./types/tari-indexer-client/ListSubstateItem";
 export * from "./types/tari-indexer-client/IndexerTransactionFinalizedResult";

package/dist/types/BlockHeader.d.ts

@@ -73,4 +73,13 @@ export type BlockHeader = {
      * Currently, this is used to store the block's sidechain_id (if applicable).
      */
     extra_data: ExtraData;
+    /**
+     * The protocol version this block was produced under, resolved from the network's activation schedule at
+     * [`Self::epoch`]. It makes the block self-describing: [`Self::calculate_hash`] and the L1 verifier in
+     * `tari_sidechain` both select the hash schema from this field rather than from the schedule.
+     *
+     * A header that carries no version is under [`ProtocolVersion::V0`], so blocks written before the field
+     * existed decode and hash unchanged.
+     */
+    protocol_version: number;
 };

package/dist/types/Command.d.ts

@@ -1,5 +1,4 @@
 import type { EndEpochAtom } from "./EndEpochAtom";
-import type { EvictNodeAtom } from "./EvictNodeAtom";
 import type { ForeignProposalAtom } from "./ForeignProposalAtom";
 import type { TransactionAtom } from "./TransactionAtom";
 export type Command = {
@@ -14,8 +13,6 @@ export type Command = {
     SomeAccept: TransactionAtom;
 } | {
     ForeignProposal: ForeignProposalAtom;
-} | {
-    EvictNode: EvictNodeAtom;
 } | {
     EndEpoch: EndEpochAtom;
 };

package/dist/types/FeeReceipt.d.ts

@@ -17,4 +17,10 @@ export type FeeReceipt = {
      * Breakdown of fee costs
      */
     cost_breakdown: FeeBreakdown;
+    /**
+     * The share of `total_fees_paid` that is burned rather than paid to leaders: `⌊paid × rate / 10_000⌋` at
+     * the exhaust burn rate in force for the execution epoch. Settled over what was collected, so it is never
+     * charged to the payer and never appears in `cost_breakdown`.
+     */
+    exhaust_burn: bigint;
 };

package/dist/types/FeeSource.d.ts

@@ -1 +1 @@
-export type FeeSource = "Initial" | "RuntimeCall" | "Storage" | "TransactionWeight" | "SignatureVerification" | "TemplateLoad" | "SubstateCreate" | "WasmExecution" | "TemplatePublish" | "ExhaustBurn" | "NativeExecution";
+export type FeeSource = "Initial" | "RuntimeCall" | "Storage" | "TransactionWeight" | "TemplateLoad" | "SubstateCreate" | "WasmExecution" | "TemplatePublish" | "Reserved" | "NativeExecution";

package/dist/types/Hash64.d.ts

@@ -1,4 +1,7 @@
 /**
  * Representation of a 64-byte hash value
+ *
+ * Encoded as a CBOR byte string rather than an array of integers, so it crosses the engine
+ * boundary in 66 bytes rather than ~130.
  */
 export type Hash64 = string;

package/dist/types/ResourceAccessRules.d.ts

@@ -20,4 +20,15 @@ export type ResourceAccessRules = {
     freeze_updater: UpdateRule;
     update_metadata: AccessRule;
     metadata_updater: UpdateRule;
+    /**
+     * Who may install, replace or remove the resource's [`AuthHook`](crate::AuthHook). The hook itself is not
+     * an [`AccessRule`], so this updater stands alone rather than pairing with one.
+     *
+     * A hook runs on nearly every resource action, so one that panics or denies unconditionally takes the
+     * resource offline and strands the balances in its vaults. `Locked` — the default — keeps a hook binding
+     * for the life of the resource; anything else lets the hook be repaired or retired, at the cost of letting
+     * whoever satisfies the updater change the rules that existing holders are relying on — up to and
+     * including giving a hook-free resource a hook.
+     */
+    auth_hook_updater: UpdateRule;
 };

package/dist/types/RuleRequirement.d.ts

@@ -13,4 +13,8 @@ export type RuleRequirement = {
     ScopedToComponent: ComponentAddress;
 } | {
     ScopedToTemplate: Hash32;
+} | {
+    CallerComponent: ComponentAddress;
+} | {
+    DirectCallerTemplate: Hash32;
 };

package/dist/types/TransactionPoolRecord.d.ts

@@ -35,7 +35,7 @@ export type TransactionPoolRecord = {
      */
     transaction_weight: bigint;
     /**
-     * The exhaust burn collected by the executor (`FeeReceipt::exhaust_burn_charged`), set from local
+     * The exhaust burn collected by the executor (`FeeReceipt::exhaust_burn`), set from local
      * execution alongside `transaction_fee`.
      */
     exhaust_burn: bigint;

package/dist/types/UtxoStateUpdateSet.d.ts

@@ -5,4 +5,5 @@ export type UtxoStateUpdateSet = {
     updates: Array<WalletUtxoUpdate>;
     max_state_version: StateVersion;
     max_epoch: Epoch;
+    has_more: boolean;
 };

package/dist/types/tari-indexer-client/GetIndexerInfoResponse.d.ts

@@ -23,12 +23,25 @@ export type GetIndexerInfoResponse = {
      */
     current_epoch: Epoch;
     /**
-     * How many epochs past its terminal epoch this indexer retains a transaction submitted through it
-     * before pruning the record. `None` means transactions are retained indefinitely. Transaction
-     * receipts are retained regardless of this setting. A client paginating transaction history hits
-     * this floor rather than the start of the chain.
+     * How many epochs past its terminal epoch this indexer retains a transaction before pruning the
+     * record. `None` means transactions are retained indefinitely. Transaction receipts are retained
+     * regardless of this setting. A client paginating transaction history hits this floor rather
+     * than the start of the chain.
      */
     transaction_retention_epochs: bigint | null;
+    /**
+     * Whether this indexer stores transactions observed on the network gossip topic in addition to
+     * those submitted directly to it. When false, a transaction submitted elsewhere is unknown to
+     * this indexer until its receipt is synced.
+     *
+     * Even when true the stored set of transactions is best effort: an indexer misses whatever was
+     * gossiped while it was offline or while its inbound queue was full, and there is no backfill.
+     * Transaction receipts carry no such caveat — they are synced from network state and are
+     * complete from genesis — so a committed transaction always has a receipt even when its body is
+     * missing here. Transactions that never committed get no receipt, so gossip is the only source
+     * for them.
+     */
+    index_gossiped_transactions: boolean;
     /**
      * Whether substates served by this indexer are verified against a shard group committee proof
      * before being returned. When false, values are served as fetched from a single validator and
@@ -36,11 +49,13 @@ export type GetIndexerInfoResponse = {
      */
     verify_substate_proofs: boolean;
     /**
-     * How long this indexer may serve a cached substate as the latest version of that substate, in
-     * seconds. A read of the latest version may be up to this stale; reads of a specific version are
-     * unaffected.
+     * How long after a shard was last confirmed synced this indexer keeps serving cached substates
+     * for it, in seconds. Cached values are invalidated by the state transitions this indexer syncs
+     * rather than expired on a timer, so a served value trails the chain by the sync interval rather
+     * than by this bound - which is what stops a validator that has stopped serving transitions from
+     * holding a stale value open indefinitely.
      */
-    latest_substate_cache_ttl_secs: bigint;
+    substate_cache_max_serve_lag_secs: bigint;
     /**
      * Whether this indexer stores every event on the network. When false it is configured with event
      * filters, so event queries answer over a subset and absence is not proof an event did not occur.

package/dist/types/tari-indexer-client/GetNetworkEconomicsResponse.d.ts

@@ -12,12 +12,12 @@ export type GetNetworkEconomicsResponse = {
      */
     total_exhaust_burned: Amount;
     /**
-     * Total pre-burn execution fees `F`, summed from transaction receipts.
+     * Total fees paid by transaction payers, summed from transaction receipts.
      */
     fee_volume: Amount;
     /**
      * Total exhaust burned summed from the same receipts as `fee_volume`; `receipt_exhaust_burned /
-     * fee_volume` is the exact realized burn rate, and this is the burn netted from `total_supply`. May
+     * fee_volume` is the exact realized burn share, and this is the burn netted from `total_supply`. May
      * transiently trail `total_exhaust_burned` while the receipt sync frontier catches up to the checkpoint
      * frontier.
      */
@@ -31,7 +31,7 @@ export type GetNetworkEconomicsResponse = {
      */
     transaction_receipt_count: bigint;
     /**
-     * The target exhaust burn rate in basis points in effect at `current_epoch`.
+     * The share of collected fees burned rather than paid to leaders, in basis points, in effect at `current_epoch`.
      */
     target_burn_rate_bps: number;
 };

package/dist/types/tari-indexer-client/ListRecentTransactionsRequest.d.ts

@@ -1,5 +1,11 @@
 import type { TransactionId } from "../TransactionId";
+import type { TransactionSource } from "./TransactionSource";
 export type ListRecentTransactionsRequest = {
     limit: number | null;
     last_id: TransactionId | null;
+    /**
+     * Restrict the listing to transactions from this source. Omitted, transactions from every
+     * source are listed.
+     */
+    source: TransactionSource | null;
 };

package/dist/types/tari-indexer-client/QueryTransactionEventsRequest.d.ts

@@ -7,9 +7,9 @@ export type QueryTransactionEventsRequest = {
     topic: string | null;
     substate_id: SubstateId | null;
     /**
-     * Filter by resource address. Matches when either the event's `substate_id` is the given
-     * resource (std.resource.* events) or the event payload contains a `resource_address` entry
-     * equal to the given address (std.vault.deposit / std.vault.withdraw).
+     * Filter by resource address. Matches the events whose `substate_id` is that resource, which
+     * is the `std.resource.*` family. Vault events name no resource — filter those by
+     * `substate_id`, the vault's ID.
      */
     resource_address?: ResourceAddress | null;
     limit: number | null;

package/dist/types/tari-indexer-client/StreamTransactionEventsRequest.d.ts

@@ -9,9 +9,9 @@ export type StreamTransactionEventsRequest = {
     substate_id: SubstateId | null;
     template_address: Hash32 | null;
     /**
-     * Filter by resource address. Matches when either the event's `substate_id` is the given
-     * resource (std.resource.* events) or the event payload contains a `resource_address` entry
-     * equal to the given address (std.vault.deposit / std.vault.withdraw).
+     * Filter by resource address. Matches the events whose `substate_id` is that resource, which
+     * is the `std.resource.*` family. Vault events name no resource — filter those by
+     * `substate_id`, the vault's ID.
      */
     resource_address?: ResourceAddress | null;
     /**

package/dist/types/tari-indexer-client/TransactionEntry.d.ts

@@ -1,6 +1,7 @@
 import type { PrunedTransaction } from "../PrunedTransaction";
 import type { TransactionId } from "../TransactionId";
 import type { TransactionResultSummary } from "./TransactionResultSummary";
+import type { TransactionSource } from "./TransactionSource";
 export type TransactionEntry = {
     transaction_id: TransactionId;
     /**
@@ -19,4 +20,8 @@ export type TransactionEntry = {
      * this indexer. None if the transaction was not rejected at submission.
      */
     rejected_reason: string | null;
+    /**
+     * Where this indexer learned of the transaction.
+     */
+    source: TransactionSource;
 };

package/dist/types/tari-indexer-client/TransactionSource.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Where an indexer learned of a transaction it has stored.
+ */
+export type TransactionSource = "local" | "gossip";

package/dist/types/tari-indexer-client/ValidatorConsensusState.d.ts

@@ -1 +1 @@
-export type ValidatorConsensusState = "Idle" | "CheckSync" | "Syncing" | "Running" | "Sleeping" | "Shutdown";
+export type ValidatorConsensusState = "Initialising" | "Idle" | "CheckSync" | "Syncing" | "Running" | "Sleeping" | "Shutdown";

package/dist/types/validator-node-client/GetBlockResponse.d.ts

@@ -2,8 +2,28 @@ import type { Block } from "../Block";
 export type GetBlockResponse = {
     block: Block;
     /**
-     * Total WASM metering points consumed by transactions executed for this block (the per-block budget is
-     * enforced against this sum).
+     * Total WASM metering points consumed by transactions executed for this block.
      */
     total_wasm_execution_points: bigint;
+    /**
+     * Total native verification points charged to transactions executed for this block.
+     */
+    total_native_execution_points: bigint;
+    /**
+     * The per-block execution points budget a leader packs against. It governs the sum of the two totals above,
+     * so only that sum is a meaningful proportion of it.
+     */
+    max_block_execution_points: bigint;
+    /**
+     * Total execution weight of the block's transaction commands: each transaction's weight discounted by how much
+     * of the work its command stage adds. Foreign proposal commands carry no execution weight and so
+     * contribute nothing.
+     */
+    total_block_execution_weight: bigint;
+    /**
+     * The execution weight a block may carry and still be voted for. Weight stands in for the size, IO and storage
+     * cost that metering does not see, so for ordinary traffic this budget fills long before the execution points
+     * one.
+     */
+    max_block_validation_weight: bigint;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tari-project/ootle-ts-bindings",
-  "version": "1.50.0",
+  "version": "1.52.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -29,7 +29,7 @@
     "prettier": "^3.8.1",
     "shx": "^0.4.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "build-dist": "tsc --project tsconfig.prod.json",

package/dist/types/EvictNodeAtom.d.ts

@@ -1,3 +0,0 @@
-export type EvictNodeAtom = {
-    public_key: string;
-};