@biglup/cometa 1.0.7 → 1.0.7001

package/dist/cjs/index.d.mts

@@ -1759,7 +1759,7 @@ declare enum NetworkMagic {
      * before they are deployed to the Mainnet. It closely mirrors the Mainnet
      * environment, providing a final testing ground for applications.
      */
-    PREPROD = 1,
+    Preprod = 1,
     /**
      * \brief The Preview test network.
      *
@@ -1767,14 +1767,14 @@ declare enum NetworkMagic {
      * before they are released to the Pre-Production network. It allows developers
      * to experiment with new functionalities in a controlled environment.
      */
-    PREVIEW = 2,
+    Preview = 2,
     /**
      * \brief The SanchoNet test network.
      *
      * SanchoNet is the testnet for rolling out governance features for the Cardano blockchain,
      * aligning with the comprehensive CIP-1694 specifications.
      */
-    SANCHONET = 4,
+    Sanchonet = 4,
     /**
      * \brief The Mainnet network.
      *
@@ -1782,7 +1782,7 @@ declare enum NetworkMagic {
      * Applications interacting with the Mainnet are dealing with actual ADA and
      * other assets. Caution should be exercised to ensure correctness and security.
      */
-    MAINNET = 764824073
+    Mainnet = 764824073
 }
 
 /**
@@ -4412,7 +4412,7 @@ declare class SoftwareBip32SecureKeyHandler implements Bip32SecureKeyHandler {
      * @returns {Promise<Bip32SecureKeyHandler>} A new instance of the key handler.
      * @warning For security, this function will zero out the `entropy` and `passphrase` Uint8Array buffers after they are used. Do not reuse them.
      */
-    static fromEntropy(entropy: Uint8Array, passphrase: Uint8Array, getPassphrase: () => Promise<Uint8Array>): Promise<Bip32SecureKeyHandler>;
+    static fromEntropy(entropy: Uint8Array, passphrase: Uint8Array, getPassphrase: () => Promise<Uint8Array>): Bip32SecureKeyHandler;
     /**
      * Deserializes an encrypted key handler from a byte array.
      *
@@ -5678,6 +5678,15 @@ declare const readTxOut: (ptr: number) => TxOut;
  * @throws {Error} Throws an error if any part of the creation fails (e.g., invalid address format).
  */
 declare const writeTxOut: (txOut: TxOut) => number;
+/**
+ * @hidden
+ * Deserializes a TxOut from its CBOR hex string representation into a TxOut object.
+ *
+ * @param {string} txOutCbor - The CBOR representation of the TxOut, encoded as a hexadecimal string.
+ * @returns {number} A pointer to the newly created value object in WASM memory.
+ * @throws {Error} Throws an error if the deserialization fails, including a descriptive message from the CBOR parser.
+ */
+declare const readTxOutFromCbor: (txOutCbor: string) => TxOut;
 
 /**
  * @hidden
@@ -5771,6 +5780,15 @@ declare const writeUtxoList: (utxos: UTxO[]) => number;
  * @returns {UTxO[]} The JavaScript representation of the UTxO list.
  */
 declare const readUtxoList: (ptr: number) => UTxO[];
+/**
+ * @hidden
+ * Deserializes a UTxO from its CBOR hex string representation into a UTxO object.
+ *
+ * @param {string} utxoCbor - The CBOR representation of the UTxO, encoded as a hexadecimal string.
+ * @returns {number} A pointer to the newly created value object in WASM memory.
+ * @throws {Error} Throws an error if the deserialization fails, including a descriptive message from the CBOR parser.
+ */
+declare const readUTxOtFromCbor: (utxoCbor: string) => UTxO;
 
 /**
  * @hidden
@@ -5792,6 +5810,15 @@ declare const readValue: (ptr: number) => Value;
  * @throws {Error} If adding an asset to the native value object fails.
  */
 declare const writeValue: (value: Value) => number;
+/**
+ * @hidden
+ * Deserializes a value from its CBOR hex string representation into a Value object.
+ *
+ * @param {string} valueCbor - The CBOR representation of the value, encoded as a hexadecimal string.
+ * @returns {number} A pointer to the newly created value object in WASM memory.
+ * @throws {Error} Throws an error if the deserialization fails, including a descriptive message from the CBOR parser.
+ */
+declare const readValueFromCbor: (valueCbor: string) => Value;
 
 /**
  * @hidden
@@ -5867,6 +5894,15 @@ declare const writeVkeyWitnessSet: (set: VkeyWitnessSet) => number;
  */
 declare const writeDerivationPaths: (paths: DerivationPath[]) => number;
 declare const writeAccountDerivationPaths: (path: AccountDerivationPath) => number;
+/**
+ * @hidden
+ * Deserializes a vkey witness set from its CBOR hex string representation into a Value object.
+ *
+ * @param {string} vkeyWitnessSetCbor - The CBOR representation of the vkey witness set, encoded as a hexadecimal string.
+ * @returns {number} A pointer to the newly created vkey witness set object in WASM memory.
+ * @throws {Error} Throws an error if the deserialization fails, including a descriptive message from the CBOR parser.
+ */
+declare const readVkeyWitnessSetFromCbor: (vkeyWitnessSetCbor: string) => VkeyWitnessSet;
 
 /**
  * @hidden
@@ -6985,4 +7021,306 @@ declare class EmscriptenTxEvaluator implements TxEvaluator {
     evaluate(tx: string, additionalUtxos?: UTxO[]): Promise<Redeemer[]>;
 }
 
-export { type AccountDerivationPath, Address, AddressType, type AlwaysAbstain, type AlwaysNoConfidence, type Anchor, type AssetAmounts, type AuthCommitteeHotCertificate, Base58, BaseAddress, Bech32, type Bech32DecodeResult, Bip32PrivateKey, Bip32PublicKey, type Bip32SecureKeyHandler, Blake2b, BlockfrostProvider, ByronAddress, ByronAddressType, CborMajorType, CborReader, CborReaderState, CborSimpleValue, CborTag, CborWriter, type Certificate, CertificateType, type CoinSelector, type CoinSelectorParams, type CoinSelectorResult, CoinType, type CommitteeMember, type CommitteeMembers, type Constitution, type ConstrPlutusData, type CostModel, Crc32, type Credential, type CredentialSet, CredentialType, type DRep, type DRepRegistrationCertificate, type DRepThresholds, type DRepUnregistrationCertificate, type Datum, DatumType, type DerivationPath, Ed25519PrivateKey, Ed25519PublicKey, type Ed25519SecureKeyHandler, Ed25519Signature, Emip003, EmscriptenCoinSelector, EmscriptenProvider, EmscriptenTxEvaluator, EnterpriseAddress, type ExUnits, type ExUnitsPrices, type GenesisKeyDelegationCertificate, type GovernanceActionId, InstanceType, KeyDerivationPurpose, KeyDerivationRole, MAX_SIGNED_64BIT, MAX_UNSIGNED_64BIT, MIN_SIGNED_64BIT, type MirCertificate, MirCertificateKind, MirCertificatePot, type MirToPot, type MirToStakeCreds, type NativeScript, NativeScriptKind, NetworkId, NetworkMagic, Pbkdf2HmacSha512, type PlutusData, PlutusLanguageVersion, type PlutusList, type PlutusMap, type PlutusScript, PointerAddress, type PoolParameters, type PoolRegistrationCertificate, type PoolRetirementCertificate, type PoolVotingThresholds, type ProtocolParameters, type ProtocolParametersUpdate, type ProtocolVersion, type Provider, type Redeemer, RedeemerPurpose, type RegistrationCertificate, type Relay, type RelayByAddress, type RelayByName, type RelayByNameMultihost, type RequireAllOfScript, type RequireAnyOfScript, type RequireAtLeastScript, type RequireSignatureScript, type RequireTimeAfterScript, type RequireTimeBeforeScript, type ResignCommitteeColdCertificate, RewardAddress, type Script, ScriptType, type SecureKeyHandler, SoftwareBip32SecureKeyHandler, SoftwareEd25519SecureKeyHandler, type StakeDelegationCertificate, type StakeDeregistrationCertificate, type StakePointer, type StakeRegistrationCertificate, type StakeRegistrationDelegationCertificate, type StakeVoteDelegationCertificate, type StakeVoteRegistrationDelegationCertificate, TransactionBuilder, type TxEvaluator, type TxIn, type TxOut, type UTxO, type UnitInterval, type UnregistrationCertificate, type UpdateDRepCertificate, type Value, type VkeyWitness, type VkeyWitnessSet, Vote, type VoteDelegationCertificate, type VoteRegistrationDelegationCertificate, type Voter, VoterType, type VotingProcedure, type Withdrawals, addWithdrawal, applyVkeyWitnessSet, assertSuccess, assetIdFromParts, assetNameFromAssetId, asyncifyStateTracker, blake2bHashFromBytes, blake2bHashFromHex, bridgeCallbacks, cborToPlutusData, cborToScript, computeScriptHash, deepEqualsPlutusData, deepEqualsScript, derefCostModel, derefCostModels, derefDRepVotingThresholds, derefExUnitPrices, derefExUnits, derefPoolVotingThresholds, derefProtocolParameters, derefProtocolVersion, derefUnitInterval, entropyToMnemonic, finalizationRegistry, getErrorString, getFromInstanceRegistry, getLibCardanoCVersion, getModule, getScriptAddress, harden, hexToBufferObject, hexToUint8Array, isDRepAbstain, isDRepCredential, isDRepNoConfidence, isNativeScript, isPlutusDataBigInt, isPlutusDataByteArray, isPlutusDataConstr, isPlutusDataList, isPlutusDataMap, isPlutusDataWithCborCache, isPlutusScript, isReady, jsonToNativeScript, mnemonicToEntropy, nativeScriptToJson, plutusDataToCbor, policyIdFromAssetId, prepareUtxoForEvaluation, readAnchor, readAssetId, readAuthCommitteeHotCertificate, readBlake2bHashData, readBufferData, readCertificate, readCommitteeMembersMap, readConstitution, readCostModel, readCostModels, readCredential, readCredentialSet, readDRepRegistrationCertificate, readDRepUnregistrationCertificate, readDRepVotingThresholds, readDatum, readExUnitPrices, readExUnits, readGenesisKeyDelegationCertificate, readGovernanceActionId, readI64, readInputSet, readIntervalComponents, readMoveInstantaneousRewardsCertificate, readPlutusData, readPoolParameters, readPoolRegistrationCertificate, readPoolRetirementCertificate, readPoolVotingThresholds, readProtocolParamUpdate, readProtocolParameters, readProtocolVersion, readRedeemer, readRedeemerList, readRedeemersFromTx, readRegistrationCertificate, readResignCommitteeColdCertificate, readScript, readStakeDelegationCertificate, readStakeDeregistrationCertificate, readStakeRegistrationCertificate, readStakeRegistrationDelegationCertificate, readStakeVoteDelegationCertificate, readStakeVoteRegistrationDelegationCertificate, readTransactionFromCbor, readTxIn, readTxOut, readUnitIntervalAsDouble, readUnregistrationCertificate, readUpdateDRepCertificate, readUtxo, readUtxoList, readValue, readVkeyWitnessSet, readVoteDelegationCertificate, readVoteRegistrationDelegationCertificate, readVoter, readVotingProcedure, readWithdrawalMap, ready, registerBridgeErrorHandler, registerInstance, reportBridgeError, scriptToCbor, splitToLowHigh64bit, toUnitInterval, uint8ArrayToHex, uint8ArrayToUtf8, unrefObject, unregisterBridgeErrorHandler, unregisterInstance, utf8ByteLen, utf8ToUint8Array, writeAccountDerivationPaths, writeAnchor, writeAssetId, writeAuthCommitteeHotCertificate, writeBytesToMemory, writeCertificate, writeCommitteeMembersMap, writeConstitution, writeCostModel, writeCostModels, writeCredential, writeCredentialSet, writeDRepRegistrationCertificate, writeDRepUnregistrationCertificate, writeDRepVotingThresholds, writeDatum, writeDerivationPaths, writeExUnitPrices, writeExUnits, writeGenesisKeyDelegationCertificate, writeGovernanceActionId, writeI64, writeInputSet, writeMoveInstantaneousRewardsCertificate, writePlutusData, writePoolParameters, writePoolRegistrationCertificate, writePoolRetirementCertificate, writePoolVotingThresholds, writeProtocolParamUpdate, writeProtocolParameters, writeProtocolVersion, writeRedeemer, writeRedeemerList, writeRegistrationCertificate, writeResignCommitteeColdCertificate, writeScript, writeStakeDelegationCertificate, writeStakeDeregistrationCertificate, writeStakeRegistrationCertificate, writeStakeRegistrationDelegationCertificate, writeStakeVoteDelegationCertificate, writeStakeVoteRegistrationDelegationCertificate, writeStringToMemory, writeTransactionToCbor, writeTxIn, writeTxOut, writeUnitInterval, writeUnitIntervalAsDouble, writeUnregistrationCertificate, writeUpdateDRepCertificate, writeUtxo, writeUtxoList, writeValue, writeVkeyWitnessSet, writeVoteDelegationCertificate, writeVoteRegistrationDelegationCertificate, writeVoter, writeVotingProcedure, writeWithdrawalMap };
+/**
+ * Represents a CIP-30 compatible Cardano wallet for dApp interaction.
+ */
+interface Cip30Wallet {
+    /**
+     * Returns the wallet's current network ID.
+     * @returns {Promise<number>} A promise that resolves to the network ID (0 for Testnet, 1 for Mainnet).
+     * @remarks This is used to ensure the dApp and wallet are operating on the same network.
+     */
+    getNetworkId(): Promise<number>;
+    /**
+     * Returns a list of all Unspent Transaction Outputs (UTXOs) controlled by the wallet.
+     * @returns {Promise<string[] | undefined>} A promise that resolves to an array of UTXOs.
+     * @remarks UTXOs represent the "coins" or assets in the wallet that are available to be spent.
+     */
+    getUtxos(): Promise<string[] | undefined>;
+    /**
+     * Returns the total balance of all assets controlled by the wallet.
+     * @returns {Promise<string>} A promise that resolves to the wallet's total balance, including Lovelace and any native tokens.
+     */
+    getBalance(): Promise<string>;
+    /**
+     * Returns a list of addresses that have been used in past transactions.
+     * @returns {Promise<string[]>} A promise that resolves to an array of used, Bech32-encoded addresses.
+     */
+    getUsedAddresses(): Promise<string[]>;
+    /**
+     * Returns a list of unused addresses for receiving payments.
+     * @returns {Promise<string[]>} A promise that resolves to an array of unused, Bech32-encoded addresses.
+     * @remarks Using a fresh address for each transaction can improve user privacy.
+     */
+    getUnusedAddresses(): Promise<string[]>;
+    /**
+     * Returns a single, unused address suitable for receiving change from a transaction.
+     * @returns {Promise<string>} A promise that resolves to a Bech32-encoded change address.
+     */
+    getChangeAddress(): Promise<string>;
+    /**
+     * Returns the wallet's reward addresses, used for receiving staking rewards.
+     * @returns {Promise<string[]>} A promise that resolves to an array of Bech32-encoded reward addresses.
+     */
+    getRewardAddresses(): Promise<string[]>;
+    /**
+     * Requests the user to sign a given transaction.
+     * @param {string} tx - The transaction to be signed, provided as a CBOR hex string.
+     * @param {boolean} partialSign - If true, the wallet will only add its witness and not require all signatures to be present. This is for multi-signature transactions.
+     * @returns {Promise<string>} A promise that resolves to the CBOR hex string of the transaction witness set.
+     */
+    signTx(tx: string, partialSign: boolean): Promise<string>;
+    /**
+     * Requests the user to sign arbitrary data with a specific address, compliant with CIP-8.
+     * @param {string} address - The Bech32-encoded address to sign with.
+     * @param {string} payload - The hex-encoded data payload to be signed.
+     * @returns {Promise<{ signature: string; key: string }>} A promise that resolves to the signature and public key.
+     * @remarks This is useful for proving ownership of an address without creating a blockchain transaction.
+     */
+    signData(address: string, payload: string): Promise<{
+        signature: string;
+        key: string;
+    }>;
+    /**
+     * Submits a fully signed transaction to the blockchain through the wallet's provider.
+     * @param {string} tx - The fully signed transaction, provided as a CBOR hex string.
+     * @returns {Promise<string>} A promise that resolves to the transaction ID (hash).
+     */
+    submitTx(tx: string): Promise<string>;
+    /**
+     * Returns a list of UTXOs that are designated as collateral.
+     * @returns {Promise<string[]>} A promise that resolves to an array of collateral UTXOs.
+     * @remarks Collateral is required for transactions that interact with Plutus smart contracts to cover potential script execution failure fees.
+     */
+    getCollateral(): Promise<string[]>;
+}
+
+/**
+ * Defines the standard interface for a Cardano wallet.
+ * This interface provides dApps with a consistent way to interact with a user's wallet for querying information
+ * and requesting transaction creation.
+ */
+interface Wallet {
+    /**
+     * Returns the wallet's current network ID.
+     * @returns {Promise<NetworkId>} A promise that resolves to the network ID (0 for Testnet, 1 for Mainnet).
+     * @remarks This is used to ensure the dApp and wallet are operating on the same network.
+     */
+    getNetworkId(): Promise<NetworkId>;
+    /**
+     * Returns a list of all Unspent Transaction Outputs (UTxOs) controlled by the wallet.
+     * @returns {Promise<UTxO[]>} A promise that resolves to an array of UTxOs.
+     * @remarks UTxOs represent the "coins" or assets in the wallet that are available to be spent.
+     */
+    getUnspentOutputs(): Promise<UTxO[]>;
+    /**
+     * Returns the total balance of all assets controlled by the wallet.
+     * @returns {Promise<Value>} A promise that resolves to the wallet's total balance, including Lovelace and any native tokens.
+     */
+    getBalance(): Promise<Value>;
+    /**
+     * Returns a list of addresses that have been used in past transactions.
+     * @returns {Promise<string[]>} A promise that resolves to an array of used, Bech32-encoded addresses.
+     */
+    getUsedAddresses(): Promise<Address[]>;
+    /**
+     * Returns a list of unused addresses for receiving payments.
+     * @returns {Promise<string[]>} A promise that resolves to an array of unused, Bech32-encoded addresses.
+     * @remarks Using a fresh address for each transaction can improve user privacy.
+     */
+    getUnusedAddresses(): Promise<Address[]>;
+    /**
+     * Returns a single, unused address suitable for receiving change from a transaction.
+     * @returns {Promise<string>} A promise that resolves to a Bech32-encoded change address.
+     */
+    getChangeAddress(): Promise<Address>;
+    /**
+     * Returns the wallet's reward addresses, used for receiving staking rewards.
+     * @returns {Promise<string[]>} A promise that resolves to an array of Bech32-encoded reward addresses.
+     */
+    getRewardAddresses(): Promise<RewardAddress[]>;
+    /**
+     * Requests the user to sign a given transaction.
+     * @param {string} txCbor - The transaction to be signed, provided as a CBOR hex string.
+     * @param {boolean} partialSign - If true, the wallet will only add its witness and not require all signatures to be present. This is for multi-signature transactions.
+     * @returns {Promise<VkeyWitness>} A promise that resolves to the CBOR hex string of the transaction witness set.
+     */
+    signTransaction(txCbor: string, partialSign: boolean): Promise<VkeyWitnessSet>;
+    /**
+     * Requests the user to sign arbitrary data with a specific address, compliant with CIP-8.
+     * @param {Address | string} address - The Bech32-encoded address to sign with.
+     * @param {string} payload - The hex-encoded data payload to be signed.
+     * @returns {Promise<{ signature: string; key: string }>} A promise that resolves to the signature and public key.
+     * @remarks This is useful for proving ownership of an address without creating a blockchain transaction.
+     */
+    signData(address: Address | string, payload: string): Promise<{
+        signature: string;
+        key: string;
+    }>;
+    /**
+     * Submits a fully signed transaction to the blockchain through the wallet's provider.
+     * @param {string} txCbor - The fully signed transaction, provided as a CBOR hex string.
+     * @returns {Promise<string>} A promise that resolves to the transaction ID (hash).
+     */
+    submitTransaction(txCbor: string): Promise<string>;
+    /**
+     * Returns a list of UTxOs that are designated as collateral.
+     * @returns {Promise<UTxO[]>} A promise that resolves to an array of collateral UTxOs.
+     * @remarks Collateral is required for transactions that interact with Plutus smart contracts to cover potential script execution failure fees.
+     */
+    getCollateral(): Promise<UTxO[]>;
+}
+
+/**
+ * Defines part of the BIP-44 derivation path components for a single Cardano address.
+ * @property {number} account - The account index.
+ * @property {number} paymentIndex - The address index for the payment key (role 0).
+ * @property {number} [stakingIndex] - The address index for the staking key (role 2). If provided, a **Base address** (payment + staking) will be derived. If omitted, an **Enterprise address** (payment only) will be derived.
+ */
+type SingleAddressCredentialsConfig = {
+    account: number;
+    paymentIndex: number;
+    stakingIndex?: number;
+};
+/**
+ * Configuration for creating a `SingleAddressWallet` instance from pre-existing key objects.
+ * @property {Bip32SecureKeyHandler} secureKeyHandler - The handler that manages encrypted private keys.
+ * @property {Bip32PublicKey} accountRootPublicKey - The public key for the specified account from which addresses are derived.
+ * @property {Provider} provider - The provider instance for interacting with the Cardano blockchain.
+ * @property {SingleAddressCredentialsConfig} credentialsConfig - Specifies the derivation path for the address this wallet will manage.
+ */
+type SingleAddressWalletConfig = {
+    secureKeyHandler: Bip32SecureKeyHandler;
+    accountRootPublicKey: Bip32PublicKey;
+    provider: Provider;
+    credentialsConfig: SingleAddressCredentialsConfig;
+};
+/**
+ * Configuration for creating a `SingleAddressWallet` instance from a mnemonic phrase.
+ * @property {string[]} mnemonics - The mnemonic (seed) phrase used to derive the root key.
+ * @property {Provider} provider - The provider instance for interacting with the Cardano blockchain.
+ * @property {SingleAddressCredentialsConfig} credentialsConfig - Specifies the derivation path for the address this wallet will manage.
+ * @property {() => Promise<Uint8Array>} getPassword - An async callback function that securely provides the password for encrypting the derived keys.
+ */
+type SingleAddressWalletFromMnemonicsConfig = {
+    mnemonics: string[];
+    provider: Provider;
+    credentialsConfig: SingleAddressCredentialsConfig;
+    getPassword: () => Promise<Uint8Array>;
+};
+/**
+ * A simple, single-address wallet implementation for programmatic use.
+ *
+ * @class SingleAddressWallet
+ * @implements {Wallet}
+ * @remarks
+ * This class provides a straightforward wallet interface that manages a single
+ * payment and staking key pair derived from a specific path. It is not a
+ * full Hierarchical Deterministic (HD) wallet and does not perform address
+ * discovery. Its simplicity makes it ideal for testing, scripting, or backend
+ * applications where interaction with a single, known address is required.
+ */
+declare class SingleAddressWallet implements Wallet {
+    private secureKeyHandler;
+    private provider;
+    private credentialsConfig;
+    private accountRootPublicKey;
+    private paymentAddress;
+    private rewardAddress;
+    /**
+     * Constructs a new instance of the SingleAddressWallet.
+     * @param {SingleAddressWalletConfig} config - The configuration object for the wallet.
+     * @remarks This constructor is private. Use the static `createFromMnemonics` method to create an instance.
+     */
+    constructor({ secureKeyHandler, provider, credentialsConfig, accountRootPublicKey }: SingleAddressWalletConfig);
+    /**
+     * Creates a new wallet instance from a mnemonic phrase.
+     *
+     * This factory method is the primary way to instantiate a wallet from a user's
+     * seed phrase, handling the necessary key derivation and encryption.
+     *
+     * @param {SingleAddressWalletFromMnemonicsConfig} config - The configuration options for creating the wallet.
+     * @returns {Promise<SingleAddressWallet>} A promise that resolves to the newly created wallet instance.
+     */
+    static createFromMnemonics({ mnemonics, provider, credentialsConfig, getPassword }: SingleAddressWalletFromMnemonicsConfig): Promise<SingleAddressWallet>;
+    /**
+     * Returns the wallet's current network ID.
+     * @returns {Promise<NetworkId>} A promise that resolves to the network ID (0 for Testnet, 1 for Mainnet).
+     */
+    getNetworkId(): Promise<NetworkId>;
+    /**
+     * Fetches all Unspent Transaction Outputs (UTxOs) for the wallet's address.
+     * @returns {Promise<UTxO[]>} A promise that resolves to an array of the wallet's UTxOs.
+     */
+    getUnspentOutputs(): Promise<UTxO[]>;
+    /**
+     * Fetches and deserializes the total balance of all assets controlled by the wallet.
+     * @returns {Promise<Value>} A promise that resolves to a `Value` object representing the wallet's complete balance.
+     */
+    getBalance(): Promise<Value>;
+    /**
+     * Fetches and parses all used addresses controlled by the wallet.
+     * @returns {Promise<Address[]>} A promise that resolves to an array of parsed `Address` objects.
+     */
+    getUsedAddresses(): Promise<Address[]>;
+    /**
+     * Fetches and parses all unused addresses controlled by the wallet.
+     * @returns {Promise<Address[]>} A promise that resolves to an array of parsed `Address` objects.
+     */
+    getUnusedAddresses(): Promise<Address[]>;
+    /**
+     * Fetches and parses a single change address from the wallet.
+     * @returns {Promise<Address>} A promise that resolves to a parsed `Address` object.
+     */
+    getChangeAddress(): Promise<Address>;
+    /**
+     * Fetches and parses all reward addresses controlled by the wallet.
+     * @returns {Promise<RewardAddress[]>} A promise that resolves to an array of parsed `RewardAddress` objects.
+     */
+    getRewardAddresses(): Promise<RewardAddress[]>;
+    /**
+     * Requests a signature for a transaction using the wallet's keys.
+     * @param {string} txCbor - The transaction to be signed, provided as a CBOR hex string.
+     * @param {boolean} partialSign - A flag to control which credentials are used for signing.
+     * @returns {Promise<VkeyWitnessSet>} A promise that resolves to the deserialized `VkeyWitnessSet`.
+     * @remarks
+     * For this type of wallet, we are going to hijack this flag and break the interface contract:
+     * - When `partialSign` is `true`, the transaction is signed **only** with the payment credential.
+     * - When `partialSign` is `false`, the transaction is signed with **both** the payment and staking credentials..
+     */
+    signTransaction(txCbor: string, partialSign: boolean): Promise<VkeyWitnessSet>;
+    /**
+     * Requests a CIP-8 compliant data signature from the wallet.
+     * @param {Address | string} _address - The address to sign with (as an `Address` object or Bech32 string).
+     * @param {string} _payload - The hex-encoded data payload to be signed.
+     * @returns {Promise<{ signature: string; key: string }>} A promise that resolves to the signature and public key.
+     */
+    signData(_address: Address | string, _payload: string): Promise<{
+        signature: string;
+        key: string;
+    }>;
+    /**
+     * Submits a fully signed transaction to the blockchain via the wallet's provider.
+     * @param {string} txCbor - The fully signed transaction as a CBOR hex string.
+     * @returns {Promise<string>} A promise that resolves to the transaction ID (hash).
+     */
+    submitTransaction(txCbor: string): Promise<string>;
+    /**
+     * Fetches and deserializes the wallet's collateral UTxOs.
+     * @returns {Promise<TxOut[]>} A promise that resolves to an array of collateral `TxOut` objects.
+     * @remarks Collateral is required for transactions involving Plutus smart contracts.
+     */
+    getCollateral(): Promise<UTxO[]>;
+    /**
+     * Derives the payment address based on the wallet's configuration.
+     * @returns {Promise<Address>} A promise resolving to a BaseAddress (with staking) or an EnterpriseAddress (without staking).
+     */
+    private getAddress;
+    /**
+     * Derives the rewards address based on the wallet's configuration.
+     * @returns {Promise<Address>} A promise resolving to a Rewards.
+     */
+    private getRewardAddress;
+}
+
+export { type AccountDerivationPath, Address, AddressType, type AlwaysAbstain, type AlwaysNoConfidence, type Anchor, type AssetAmounts, type AuthCommitteeHotCertificate, Base58, BaseAddress, Bech32, type Bech32DecodeResult, Bip32PrivateKey, Bip32PublicKey, type Bip32SecureKeyHandler, Blake2b, BlockfrostProvider, ByronAddress, ByronAddressType, CborMajorType, CborReader, CborReaderState, CborSimpleValue, CborTag, CborWriter, type Certificate, CertificateType, type Cip30Wallet, type CoinSelector, type CoinSelectorParams, type CoinSelectorResult, CoinType, type CommitteeMember, type CommitteeMembers, type Constitution, type ConstrPlutusData, type CostModel, Crc32, type Credential, type CredentialSet, CredentialType, type DRep, type DRepRegistrationCertificate, type DRepThresholds, type DRepUnregistrationCertificate, type Datum, DatumType, type DerivationPath, Ed25519PrivateKey, Ed25519PublicKey, type Ed25519SecureKeyHandler, Ed25519Signature, Emip003, EmscriptenCoinSelector, EmscriptenProvider, EmscriptenTxEvaluator, EnterpriseAddress, type ExUnits, type ExUnitsPrices, type GenesisKeyDelegationCertificate, type GovernanceActionId, InstanceType, KeyDerivationPurpose, KeyDerivationRole, MAX_SIGNED_64BIT, MAX_UNSIGNED_64BIT, MIN_SIGNED_64BIT, type MirCertificate, MirCertificateKind, MirCertificatePot, type MirToPot, type MirToStakeCreds, type NativeScript, NativeScriptKind, NetworkId, NetworkMagic, Pbkdf2HmacSha512, type PlutusData, PlutusLanguageVersion, type PlutusList, type PlutusMap, type PlutusScript, PointerAddress, type PoolParameters, type PoolRegistrationCertificate, type PoolRetirementCertificate, type PoolVotingThresholds, type ProtocolParameters, type ProtocolParametersUpdate, type ProtocolVersion, type Provider, type Redeemer, RedeemerPurpose, type RegistrationCertificate, type Relay, type RelayByAddress, type RelayByName, type RelayByNameMultihost, type RequireAllOfScript, type RequireAnyOfScript, type RequireAtLeastScript, type RequireSignatureScript, type RequireTimeAfterScript, type RequireTimeBeforeScript, type ResignCommitteeColdCertificate, RewardAddress, type Script, ScriptType, type SecureKeyHandler, type SingleAddressCredentialsConfig, SingleAddressWallet, type SingleAddressWalletConfig, type SingleAddressWalletFromMnemonicsConfig, SoftwareBip32SecureKeyHandler, SoftwareEd25519SecureKeyHandler, type StakeDelegationCertificate, type StakeDeregistrationCertificate, type StakePointer, type StakeRegistrationCertificate, type StakeRegistrationDelegationCertificate, type StakeVoteDelegationCertificate, type StakeVoteRegistrationDelegationCertificate, TransactionBuilder, type TxEvaluator, type TxIn, type TxOut, type UTxO, type UnitInterval, type UnregistrationCertificate, type UpdateDRepCertificate, type Value, type VkeyWitness, type VkeyWitnessSet, Vote, type VoteDelegationCertificate, type VoteRegistrationDelegationCertificate, type Voter, VoterType, type VotingProcedure, type Wallet, type Withdrawals, addWithdrawal, applyVkeyWitnessSet, assertSuccess, assetIdFromParts, assetNameFromAssetId, asyncifyStateTracker, blake2bHashFromBytes, blake2bHashFromHex, bridgeCallbacks, cborToPlutusData, cborToScript, computeScriptHash, deepEqualsPlutusData, deepEqualsScript, derefCostModel, derefCostModels, derefDRepVotingThresholds, derefExUnitPrices, derefExUnits, derefPoolVotingThresholds, derefProtocolParameters, derefProtocolVersion, derefUnitInterval, entropyToMnemonic, finalizationRegistry, getErrorString, getFromInstanceRegistry, getLibCardanoCVersion, getModule, getScriptAddress, harden, hexToBufferObject, hexToUint8Array, isDRepAbstain, isDRepCredential, isDRepNoConfidence, isNativeScript, isPlutusDataBigInt, isPlutusDataByteArray, isPlutusDataConstr, isPlutusDataList, isPlutusDataMap, isPlutusDataWithCborCache, isPlutusScript, isReady, jsonToNativeScript, mnemonicToEntropy, nativeScriptToJson, plutusDataToCbor, policyIdFromAssetId, prepareUtxoForEvaluation, readAnchor, readAssetId, readAuthCommitteeHotCertificate, readBlake2bHashData, readBufferData, readCertificate, readCommitteeMembersMap, readConstitution, readCostModel, readCostModels, readCredential, readCredentialSet, readDRepRegistrationCertificate, readDRepUnregistrationCertificate, readDRepVotingThresholds, readDatum, readExUnitPrices, readExUnits, readGenesisKeyDelegationCertificate, readGovernanceActionId, readI64, readInputSet, readIntervalComponents, readMoveInstantaneousRewardsCertificate, readPlutusData, readPoolParameters, readPoolRegistrationCertificate, readPoolRetirementCertificate, readPoolVotingThresholds, readProtocolParamUpdate, readProtocolParameters, readProtocolVersion, readRedeemer, readRedeemerList, readRedeemersFromTx, readRegistrationCertificate, readResignCommitteeColdCertificate, readScript, readStakeDelegationCertificate, readStakeDeregistrationCertificate, readStakeRegistrationCertificate, readStakeRegistrationDelegationCertificate, readStakeVoteDelegationCertificate, readStakeVoteRegistrationDelegationCertificate, readTransactionFromCbor, readTxIn, readTxOut, readTxOutFromCbor, readUTxOtFromCbor, readUnitIntervalAsDouble, readUnregistrationCertificate, readUpdateDRepCertificate, readUtxo, readUtxoList, readValue, readValueFromCbor, readVkeyWitnessSet, readVkeyWitnessSetFromCbor, readVoteDelegationCertificate, readVoteRegistrationDelegationCertificate, readVoter, readVotingProcedure, readWithdrawalMap, ready, registerBridgeErrorHandler, registerInstance, reportBridgeError, scriptToCbor, splitToLowHigh64bit, toUnitInterval, uint8ArrayToHex, uint8ArrayToUtf8, unrefObject, unregisterBridgeErrorHandler, unregisterInstance, utf8ByteLen, utf8ToUint8Array, writeAccountDerivationPaths, writeAnchor, writeAssetId, writeAuthCommitteeHotCertificate, writeBytesToMemory, writeCertificate, writeCommitteeMembersMap, writeConstitution, writeCostModel, writeCostModels, writeCredential, writeCredentialSet, writeDRepRegistrationCertificate, writeDRepUnregistrationCertificate, writeDRepVotingThresholds, writeDatum, writeDerivationPaths, writeExUnitPrices, writeExUnits, writeGenesisKeyDelegationCertificate, writeGovernanceActionId, writeI64, writeInputSet, writeMoveInstantaneousRewardsCertificate, writePlutusData, writePoolParameters, writePoolRegistrationCertificate, writePoolRetirementCertificate, writePoolVotingThresholds, writeProtocolParamUpdate, writeProtocolParameters, writeProtocolVersion, writeRedeemer, writeRedeemerList, writeRegistrationCertificate, writeResignCommitteeColdCertificate, writeScript, writeStakeDelegationCertificate, writeStakeDeregistrationCertificate, writeStakeRegistrationCertificate, writeStakeRegistrationDelegationCertificate, writeStakeVoteDelegationCertificate, writeStakeVoteRegistrationDelegationCertificate, writeStringToMemory, writeTransactionToCbor, writeTxIn, writeTxOut, writeUnitInterval, writeUnitIntervalAsDouble, writeUnregistrationCertificate, writeUpdateDRepCertificate, writeUtxo, writeUtxoList, writeValue, writeVkeyWitnessSet, writeVoteDelegationCertificate, writeVoteRegistrationDelegationCertificate, writeVoter, writeVotingProcedure, writeWithdrawalMap };