@tari-project/ootle-ts-bindings 1.44.6 → 1.47.1

package/dist/helpers/helpers.js

@@ -152,6 +152,9 @@ export function permissionToString(permission) {
         return `settings:${permission.Settings.toLowerCase()}`;
     if ("AddressBook" in permission)
         return `address_book:${permission.AddressBook.toLowerCase()}`;
+    if ("TransactionRequests" in permission) {
+        return `transaction_requests:${permission.TransactionRequests.toLowerCase()}`;
+    }
     // Scoped CRUD resources: { Accounts: ["Read", "component_abc..." | null] }.
     if ("Accounts" in permission)
         return scoped("accounts", permission.Accounts);

package/dist/index.d.ts

@@ -179,6 +179,7 @@ export * from "./types/TransactionSealSignature";
 export * from "./types/TransactionSignature";
 export * from "./types/TransactionStatus";
 export * from "./types/TransactionV1";
+export * from "./types/TxRequestAction";
 export * from "./types/Type";
 export * from "./types/UnsealedTransaction";
 export * from "./types/UnsealedTransactionV1";

package/dist/index.js

@@ -181,6 +181,7 @@ export * from "./types/TransactionSealSignature";
 export * from "./types/TransactionSignature";
 export * from "./types/TransactionStatus";
 export * from "./types/TransactionV1";
+export * from "./types/TxRequestAction";
 export * from "./types/Type";
 export * from "./types/UnsealedTransaction";
 export * from "./types/UnsealedTransactionV1";

package/dist/types/FeeSource.d.ts

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

package/dist/types/Instruction.d.ts

@@ -51,6 +51,7 @@ export type Instruction = {
 } | {
     ClaimValidatorFees: {
         address: ValidatorFeePoolAddress;
+        max_amount: Amount | null;
     };
 } | "DropAllProofsInWorkspace" | {
     Assert: {

package/dist/types/Permission.d.ts

@@ -2,6 +2,7 @@ import type { ComponentAddress } from "./ComponentAddress";
 import type { Crud } from "./Crud";
 import type { ReadOnly } from "./ReadOnly";
 import type { ResourceAddress } from "./ResourceAddress";
+import type { TxRequestAction } from "./TxRequestAction";
 /**
  * A capability the wallet daemon recognises as granted by a caller or required
  * by a handler.
@@ -18,6 +19,8 @@ export type Permission = "Admin" | {
     Keys: Crud;
 } | {
     Transactions: Crud;
+} | {
+    TransactionRequests: TxRequestAction;
 } | {
     Transfer: [Crud, ComponentAddress | null];
 } | {

package/dist/types/TxRequestAction.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Actions on a transaction request. Deliberately not [`Crud`]: approving is
+ * not a mutation of the request, it is the act that authorises the value
+ * transfer the request describes. Modelling it as `Update` would let any
+ * grant carrying edit rights approve.
+ */
+export type TxRequestAction = "Read" | "Create" | "Approve";

package/dist/types/TxRequestAction.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/types/wallet-types/EffectiveStatus.d.ts

@@ -0,0 +1,5 @@
+/**
+ * What a caller sees for a request: its stored status, or `Expired` when the
+ * approval window has closed on a request that never reached a terminal state.
+ */
+export type EffectiveStatus = "Pending" | "Approved" | "Rejected" | "Submitting" | "Submitted" | "Expired";

package/dist/types/wallet-types/EffectiveStatus.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/types/wallet-types/InputSelection.d.ts

@@ -1,9 +1,14 @@
 import type { Amount } from "../Amount";
+import type { UtxoAddress } from "../UtxoAddress";
 import type { UtxoInputSelection } from "../UtxoInputSelection";
 export type InputSelection = {
-    FromBucket: {
+    "FromBucket": {
         revealed_amount: Amount;
     };
 } | {
-    Selection: UtxoInputSelection;
+    "Selection": UtxoInputSelection;
+} | {
+    "Specific": {
+        utxo_addresses: Array<UtxoAddress>;
+    };
 };

package/dist/types/wallet-types/TransactionDetectInputsRequest.d.ts

@@ -0,0 +1,9 @@
+import type { UnsignedTransaction } from "../UnsignedTransaction";
+export type TransactionDetectInputsRequest = {
+    transaction: UnsignedTransaction;
+    /**
+     * If true (default), detected inputs omit versions so consensus resolves
+     * them; if false, walletd pins the versions it currently knows.
+     */
+    use_unversioned: boolean;
+};

package/dist/types/wallet-types/TransactionDetectInputsRequest.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionDetectInputsResponse.d.ts

@@ -0,0 +1,7 @@
+import type { UnsignedTransaction } from "../UnsignedTransaction";
+export type TransactionDetectInputsResponse = {
+    /**
+     * The input transaction with the detected inputs merged in.
+     */
+    transaction: UnsignedTransaction;
+};

package/dist/types/wallet-types/TransactionDetectInputsResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestCreateRequest.d.ts

@@ -0,0 +1,46 @@
+import type { TransactionSignature } from "../TransactionSignature";
+import type { UnsignedTransaction } from "../UnsignedTransaction";
+import type { KeyId } from "./KeyId";
+/**
+ * Create a transaction request for a separately-permissioned principal to
+ * approve (issue #2343).
+ *
+ * The transaction is stored verbatim and frozen: what the approver views is
+ * what submit seals. The caller supplies a complete transaction (inputs
+ * resolved, any out-of-band signatures collected); walletd does not alter it.
+ */
+export type TransactionRequestCreateRequest = {
+    /**
+     * The transaction, stored verbatim. Inputs must already be resolved: the
+     * request path does not detect them, so that a caller who has already
+     * collected signatures over these exact bytes is not invalidated. Use
+     * `transactions.detect_inputs` first if the caller cannot resolve them.
+     */
+    transaction: UnsignedTransaction;
+    /**
+     * Who pays and seals last.
+     */
+    seal_signer: KeyId;
+    /**
+     * Wallet keys walletd signs with at submit.
+     */
+    other_signers: Array<KeyId>;
+    /**
+     * Signatures collected out of band (e.g. from an external co-signer) over
+     * `transaction` and `seal_signer`'s public key. Attached verbatim at
+     * submit. Their presence means the transaction is final, so nothing about
+     * it is altered after creation.
+     */
+    signatures: Array<TransactionSignature>;
+    /**
+     * Locks holding this request's inputs. Their timeouts are extended to
+     * outlive the approval window. Stealth spend keys are derived from these
+     * at submit -- a caller cannot name them.
+     */
+    lock_ids: Array<number>;
+    /**
+     * How long a human has to approve, in seconds. Defaults to the daemon's
+     * configured window.
+     */
+    ttl_secs: number | null;
+};

package/dist/types/wallet-types/TransactionRequestCreateRequest.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestCreateResponse.d.ts

@@ -0,0 +1,7 @@
+export type TransactionRequestCreateResponse = {
+    request_id: number;
+    /**
+     * Unix timestamp (seconds).
+     */
+    expires_at: bigint;
+};

package/dist/types/wallet-types/TransactionRequestCreateResponse.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/types/wallet-types/TransactionRequestDecisionRequest.d.ts

@@ -0,0 +1,3 @@
+export type TransactionRequestDecisionRequest = {
+    request_id: number;
+};

package/dist/types/wallet-types/TransactionRequestDecisionRequest.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/types/wallet-types/TransactionRequestDecisionResponse.d.ts

@@ -0,0 +1,5 @@
+import type { EffectiveStatus } from "./EffectiveStatus";
+export type TransactionRequestDecisionResponse = {
+    request_id: number;
+    status: EffectiveStatus;
+};

package/dist/types/wallet-types/TransactionRequestDecisionResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestGetRequest.d.ts

@@ -0,0 +1,3 @@
+export type TransactionRequestGetRequest = {
+    request_id: number;
+};

package/dist/types/wallet-types/TransactionRequestGetRequest.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/types/wallet-types/TransactionRequestGetResponse.d.ts

@@ -0,0 +1,4 @@
+import type { TransactionRequestInfo } from "./TransactionRequestInfo";
+export type TransactionRequestGetResponse = {
+    request: TransactionRequestInfo;
+};

package/dist/types/wallet-types/TransactionRequestGetResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestInfo.d.ts

@@ -0,0 +1,38 @@
+import type { TransactionId } from "../TransactionId";
+import type { UnsignedTransaction } from "../UnsignedTransaction";
+import type { EffectiveStatus } from "./EffectiveStatus";
+import type { KeyId } from "./KeyId";
+import type { TransactionRequestValueSummary } from "./TransactionRequestValueSummary";
+export type TransactionRequestInfo = {
+    request_id: number;
+    /**
+     * The frozen transaction, decoded for display. These are the exact bytes
+     * an approval commits to.
+     */
+    transaction: UnsignedTransaction;
+    seal_signer: KeyId;
+    other_signers: Array<KeyId>;
+    /**
+     * Admin-assigned name of the API key that created this request, or `None`
+     * for a wallet session. Display only -- nothing authorises on it.
+     */
+    requested_by: string | null;
+    status: EffectiveStatus;
+    transaction_id: TransactionId | null;
+    /**
+     * `None` for an ordinary transaction, whose instructions are readable.
+     */
+    value_summary: TransactionRequestValueSummary | null;
+    /**
+     * Unix timestamp (seconds).
+     */
+    expires_at: bigint;
+    /**
+     * Unix timestamp (seconds). `None` until approved.
+     */
+    approved_at: bigint | null;
+    /**
+     * Unix timestamp (seconds).
+     */
+    created_at: bigint;
+};

package/dist/types/wallet-types/TransactionRequestInfo.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestListRequest.d.ts

@@ -0,0 +1,7 @@
+import type { EffectiveStatus } from "./EffectiveStatus";
+export type TransactionRequestListRequest = {
+    /**
+     * Only return requests whose effective status matches.
+     */
+    status: EffectiveStatus | null;
+};

package/dist/types/wallet-types/TransactionRequestListRequest.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestListResponse.d.ts

@@ -0,0 +1,4 @@
+import type { TransactionRequestInfo } from "./TransactionRequestInfo";
+export type TransactionRequestListResponse = {
+    requests: Array<TransactionRequestInfo>;
+};

package/dist/types/wallet-types/TransactionRequestListResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestSubmitRequest.d.ts

@@ -0,0 +1,3 @@
+export type TransactionRequestSubmitRequest = {
+    request_id: number;
+};

package/dist/types/wallet-types/TransactionRequestSubmitRequest.js

@@ -0,0 +1,2 @@
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+export {};

package/dist/types/wallet-types/TransactionRequestSubmitResponse.d.ts

@@ -0,0 +1,4 @@
+import type { TransactionId } from "../TransactionId";
+export type TransactionRequestSubmitResponse = {
+    transaction_id: TransactionId;
+};

package/dist/types/wallet-types/TransactionRequestSubmitResponse.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionRequestValueSummary.d.ts

@@ -0,0 +1,24 @@
+import type { ResourceAddress } from "../ResourceAddress";
+/**
+ * Net value movement for a stealth or confidential transfer, computed by the
+ * wallet from the request's locks.
+ *
+ * A stealth transfer's instructions are commitments and range proofs, so a
+ * human cannot read the amount out of them. The wallet owns the masks and is
+ * the only party that can state what leaves the account.
+ */
+export type TransactionRequestValueSummary = {
+    resource_address: ResourceAddress;
+    /**
+     * Total value of the inputs this request spends.
+     */
+    inputs_total: bigint;
+    /**
+     * Total value returning to this wallet as change.
+     */
+    change_total: bigint;
+    /**
+     * `inputs_total - change_total`: what actually leaves, before fees.
+     */
+    amount_leaving: bigint;
+};

package/dist/types/wallet-types/TransactionRequestValueSummary.js

@@ -0,0 +1 @@
+export {};

package/dist/types/wallet-types/TransactionSubmitRequest.d.ts

@@ -1,9 +1,15 @@
+import type { TransactionSignature } from "../TransactionSignature";
 import type { UnsignedTransaction } from "../UnsignedTransaction";
 import type { KeyId } from "./KeyId";
 export type TransactionSubmitRequest = {
     transaction: UnsignedTransaction;
     seal_signer: KeyId;
     other_signers: Array<KeyId>;
+    /**
+     * Signatures collected out of band, attached before walletd adds its own
+     * and seals.
+     */
+    signatures: Array<TransactionSignature>;
     /**
      * Attempt to infer inputs and their dependencies from instructions. If false, the provided transaction must
      * contain the required inputs.

package/dist/wallet-types.d.ts

@@ -181,3 +181,18 @@ export * from "./types/wallet-types/TemplatesListAuthoredResponse";
 export * from "./types/wallet-types/StealthUtxosDecryptValueResponse";
 export * from "./types/wallet-types/StealthUtxosGetValueLookupInfoRequest";
 export * from "./types/wallet-types/StealthUtxosGetValueLookupInfoResponse";
+export * from "./types/wallet-types/EffectiveStatus";
+export * from "./types/wallet-types/TransactionRequestCreateRequest";
+export * from "./types/wallet-types/TransactionRequestCreateResponse";
+export * from "./types/wallet-types/TransactionRequestDecisionRequest";
+export * from "./types/wallet-types/TransactionRequestDecisionResponse";
+export * from "./types/wallet-types/TransactionRequestGetRequest";
+export * from "./types/wallet-types/TransactionRequestGetResponse";
+export * from "./types/wallet-types/TransactionRequestInfo";
+export * from "./types/wallet-types/TransactionRequestListRequest";
+export * from "./types/wallet-types/TransactionRequestListResponse";
+export * from "./types/wallet-types/TransactionRequestSubmitRequest";
+export * from "./types/wallet-types/TransactionRequestSubmitResponse";
+export * from "./types/wallet-types/TransactionRequestValueSummary";
+export * from "./types/wallet-types/TransactionDetectInputsRequest";
+export * from "./types/wallet-types/TransactionDetectInputsResponse";

package/dist/wallet-types.js

@@ -183,3 +183,18 @@ export * from "./types/wallet-types/TemplatesListAuthoredResponse";
 export * from "./types/wallet-types/StealthUtxosDecryptValueResponse";
 export * from "./types/wallet-types/StealthUtxosGetValueLookupInfoRequest";
 export * from "./types/wallet-types/StealthUtxosGetValueLookupInfoResponse";
+export * from "./types/wallet-types/EffectiveStatus";
+export * from "./types/wallet-types/TransactionRequestCreateRequest";
+export * from "./types/wallet-types/TransactionRequestCreateResponse";
+export * from "./types/wallet-types/TransactionRequestDecisionRequest";
+export * from "./types/wallet-types/TransactionRequestDecisionResponse";
+export * from "./types/wallet-types/TransactionRequestGetRequest";
+export * from "./types/wallet-types/TransactionRequestGetResponse";
+export * from "./types/wallet-types/TransactionRequestInfo";
+export * from "./types/wallet-types/TransactionRequestListRequest";
+export * from "./types/wallet-types/TransactionRequestListResponse";
+export * from "./types/wallet-types/TransactionRequestSubmitRequest";
+export * from "./types/wallet-types/TransactionRequestSubmitResponse";
+export * from "./types/wallet-types/TransactionRequestValueSummary";
+export * from "./types/wallet-types/TransactionDetectInputsRequest";
+export * from "./types/wallet-types/TransactionDetectInputsResponse";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tari-project/ootle-ts-bindings",
-  "version": "1.44.6",
+  "version": "1.47.1",
   "private": false,
   "publishConfig": {
     "access": "public"