@dashevo/evo-sdk 3.0.0-dev.5 → 3.0.0-dev.7

package/dist/addresses/facade.d.ts

@@ -0,0 +1,210 @@
+import * as wasm from '../wasm.js';
+import type { EvoSDK } from '../sdk.js';
+export declare class AddressesFacade {
+    private sdk;
+    constructor(sdk: EvoSDK);
+    /**
+     * Fetches information about a Platform address including its nonce and balance.
+     *
+     * @param address - The platform address to query (PlatformAddress, Uint8Array, or bech32m string)
+     * @returns PlatformAddressInfo containing address, nonce, and balance, or undefined if not found
+     */
+    get(address: wasm.PlatformAddressLike): Promise<wasm.PlatformAddressInfo | undefined>;
+    /**
+     * Fetches information about a Platform address with proof.
+     *
+     * @param address - The platform address to query (PlatformAddress, Uint8Array, or bech32m string)
+     * @returns ProofMetadataResponse containing PlatformAddressInfo with proof information
+     */
+    getWithProof(address: wasm.PlatformAddressLike): Promise<wasm.ProofMetadataResponseTyped<wasm.PlatformAddressInfo>>;
+    /**
+     * Fetches information about multiple Platform addresses.
+     *
+     * @param addresses - Array of platform addresses to query
+     * @returns Map of PlatformAddress to PlatformAddressInfo (or undefined for unfunded addresses)
+     */
+    getMany(addresses: wasm.PlatformAddressLike[]): Promise<Map<wasm.PlatformAddress, wasm.PlatformAddressInfo | undefined>>;
+    /**
+     * Fetches information about multiple Platform addresses with proof.
+     *
+     * @param addresses - Array of platform addresses to query
+     * @returns ProofMetadataResponse containing Map of PlatformAddress to PlatformAddressInfo
+     */
+    getManyWithProof(addresses: wasm.PlatformAddressLike[]): Promise<wasm.ProofMetadataResponseTyped<Map<wasm.PlatformAddress, wasm.PlatformAddressInfo | undefined>>>;
+    /**
+     * Transfers credits between Platform addresses.
+     *
+     * @param options - Transfer options including inputs, outputs, and signer
+     * @returns Promise resolving to transfer result with updated address information
+     *
+     * @example
+     * ```typescript
+     * const recipientAddr = PlatformAddress.fromBech32m("tdashevo1...");
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * const signer = new PlatformAddressSigner();
+     * const senderAddr = signer.addKey(privateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(senderAddr, 0n, 100000n);
+     * const output = new PlatformAddressOutput(recipientAddr, 90000n);
+     *
+     * const result = await sdk.addresses.transfer({
+     *   inputs: [input],
+     *   outputs: [output],
+     *   signer
+     * });
+     * ```
+     */
+    transfer(options: wasm.AddressFundsTransferOptions): Promise<Map<wasm.PlatformAddress, wasm.PlatformAddressInfo>>;
+    /**
+     * Top up an identity from Platform addresses.
+     *
+     * @param options - Top up options including identity ID, inputs, and signer
+     * @returns Promise resolving to result with updated address infos and new identity balance
+     *
+     * @example
+     * ```typescript
+     * const identityId = Identifier.from("...");
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * const signer = new PlatformAddressSigner();
+     * const sourceAddr = signer.addKey(privateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(sourceAddr, 0n, 50000n);
+     *
+     * const result = await sdk.addresses.topUpIdentity({
+     *   identityId,
+     *   inputs: [input],
+     *   signer
+     * });
+     *
+     * console.log('New identity balance:', result.newBalance);
+     * ```
+     */
+    topUpIdentity(options: wasm.IdentityTopUpFromAddressesOptions): Promise<wasm.IdentityTopUpFromAddressesResult>;
+    /**
+     * Withdraws Platform address credits to Dash Core.
+     *
+     * @param options - Withdrawal options including inputs, output script, pooling, and signer
+     * @returns Promise resolving to Map of PlatformAddress to PlatformAddressInfo
+     *
+     * @example
+     * ```typescript
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * // Create Core output script for L1 destination
+     * const coreScript = CoreScript.newP2PKH(coreAddressHash);
+     *
+     * const signer = new PlatformAddressSigner();
+     * const platformAddr = signer.addKey(privateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(platformAddr, 0n, 100000n);
+     *
+     * const result = await sdk.addresses.withdraw({
+     *   inputs: [input],
+     *   coreFeePerByte: 1,
+     *   pooling: PoolingWasm.Standard,
+     *   outputScript: coreScript,
+     *   signer
+     * });
+     * ```
+     */
+    withdraw(options: wasm.AddressFundsWithdrawOptions): Promise<Map<wasm.PlatformAddress, wasm.PlatformAddressInfo>>;
+    /**
+     * Transfer credits from an identity to Platform addresses.
+     *
+     * @param options - Transfer options including identity ID, outputs, and signer
+     * @returns Result with updated address information and new identity balance
+     *
+     * @example
+     * ```typescript
+     * const identityId = Identifier.from("...");
+     * const recipientAddr = PlatformAddress.fromBech32m("tdashevo1...");
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif..."); // Identity transfer key
+     *
+     * const output = new PlatformAddressOutput(recipientAddr, 100000n);
+     *
+     * // Create identity signer and add the transfer key
+     * const signer = new IdentitySigner();
+     * signer.addKey(privateKey);
+     *
+     * const result = await sdk.addresses.transferFromIdentity({
+     *   identityId,
+     *   outputs: [output],
+     *   signer
+     * });
+     *
+     * console.log(`New identity balance: ${result.newBalance}`);
+     * console.log(`Updated addresses:`, result.addressInfos);
+     * ```
+     */
+    transferFromIdentity(options: wasm.IdentityTransferToAddressesOptions): Promise<wasm.IdentityTransferToAddressesResult>;
+    /**
+     * Fund Platform addresses from an asset lock.
+     *
+     * @param options - Funding options including asset lock proof, outputs, and signer
+     * @returns Promise resolving to Map of PlatformAddress to PlatformAddressInfo
+     *
+     * @example
+     * ```typescript
+     * const assetLockPrivateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     * const addressPrivateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * // Create asset lock proof from L1 transaction
+     * const assetLockProof = AssetLockProof.createInstantAssetLockProof(
+     *   instantLockBytes,
+     *   transactionBytes,
+     *   outputIndex
+     * );
+     *
+     * const signer = new PlatformAddressSigner();
+     * const platformAddr = signer.addKey(addressPrivateKey); // Derives P2PKH address from key
+     *
+     * const output = new PlatformAddressOutput(platformAddr, 100000n);
+     *
+     * const result = await sdk.addresses.fundFromAssetLock({
+     *   assetLockProof,
+     *   assetLockPrivateKey,
+     *   outputs: [output],
+     *   signer
+     * });
+     * ```
+     */
+    fundFromAssetLock(options: wasm.AddressFundingFromAssetLockOptions): Promise<Map<wasm.PlatformAddress, wasm.PlatformAddressInfo>>;
+    /**
+     * Create an identity funded from Platform addresses.
+     *
+     * @param options - Creation options including identity, inputs, and signers
+     * @returns Promise resolving to result with created identity and updated address infos
+     *
+     * @example
+     * ```typescript
+     * const addressPrivateKey = PrivateKey.fromWIF("cAddressPrivateKeyWif...");
+     * const identityPrivateKey = PrivateKey.fromWIF("cIdentityKeyWif...");
+     *
+     * // Create identity structure with public keys
+     * const identity = new Identity(Identifier.random());
+     * identity.addPublicKey(identityPublicKey);
+     *
+     * // Create signers
+     * const addressSigner = new PlatformAddressSigner();
+     * const sourceAddr = addressSigner.addKey(addressPrivateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(sourceAddr, 0n, 100000n);
+     *
+     * const identitySigner = new IdentitySigner();
+     * identitySigner.addKey(identityPrivateKey);
+     *
+     * const result = await sdk.addresses.createIdentity({
+     *   identity,
+     *   inputs: [input],
+     *   identitySigner,
+     *   addressSigner
+     * });
+     *
+     * console.log('Created identity:', result.identity.id());
+     * console.log('Updated addresses:', result.addressInfos);
+     * ```
+     */
+    createIdentity(options: wasm.IdentityCreateFromAddressesOptions): Promise<wasm.IdentityCreateFromAddressesResult>;
+}

package/dist/addresses/facade.js

@@ -0,0 +1,239 @@
+export class AddressesFacade {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    /**
+     * Fetches information about a Platform address including its nonce and balance.
+     *
+     * @param address - The platform address to query (PlatformAddress, Uint8Array, or bech32m string)
+     * @returns PlatformAddressInfo containing address, nonce, and balance, or undefined if not found
+     */
+    async get(address) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.getAddressInfo(address);
+    }
+    /**
+     * Fetches information about a Platform address with proof.
+     *
+     * @param address - The platform address to query (PlatformAddress, Uint8Array, or bech32m string)
+     * @returns ProofMetadataResponse containing PlatformAddressInfo with proof information
+     */
+    async getWithProof(address) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.getAddressInfoWithProofInfo(address);
+    }
+    /**
+     * Fetches information about multiple Platform addresses.
+     *
+     * @param addresses - Array of platform addresses to query
+     * @returns Map of PlatformAddress to PlatformAddressInfo (or undefined for unfunded addresses)
+     */
+    async getMany(addresses) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.getAddressesInfos(addresses);
+    }
+    /**
+     * Fetches information about multiple Platform addresses with proof.
+     *
+     * @param addresses - Array of platform addresses to query
+     * @returns ProofMetadataResponse containing Map of PlatformAddress to PlatformAddressInfo
+     */
+    async getManyWithProof(addresses) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.getAddressesInfosWithProofInfo(addresses);
+    }
+    /**
+     * Transfers credits between Platform addresses.
+     *
+     * @param options - Transfer options including inputs, outputs, and signer
+     * @returns Promise resolving to transfer result with updated address information
+     *
+     * @example
+     * ```typescript
+     * const recipientAddr = PlatformAddress.fromBech32m("tdashevo1...");
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * const signer = new PlatformAddressSigner();
+     * const senderAddr = signer.addKey(privateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(senderAddr, 0n, 100000n);
+     * const output = new PlatformAddressOutput(recipientAddr, 90000n);
+     *
+     * const result = await sdk.addresses.transfer({
+     *   inputs: [input],
+     *   outputs: [output],
+     *   signer
+     * });
+     * ```
+     */
+    async transfer(options) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.addressFundsTransfer(options);
+    }
+    /**
+     * Top up an identity from Platform addresses.
+     *
+     * @param options - Top up options including identity ID, inputs, and signer
+     * @returns Promise resolving to result with updated address infos and new identity balance
+     *
+     * @example
+     * ```typescript
+     * const identityId = Identifier.from("...");
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * const signer = new PlatformAddressSigner();
+     * const sourceAddr = signer.addKey(privateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(sourceAddr, 0n, 50000n);
+     *
+     * const result = await sdk.addresses.topUpIdentity({
+     *   identityId,
+     *   inputs: [input],
+     *   signer
+     * });
+     *
+     * console.log('New identity balance:', result.newBalance);
+     * ```
+     */
+    async topUpIdentity(options) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.identityTopUpFromAddresses(options);
+    }
+    /**
+     * Withdraws Platform address credits to Dash Core.
+     *
+     * @param options - Withdrawal options including inputs, output script, pooling, and signer
+     * @returns Promise resolving to Map of PlatformAddress to PlatformAddressInfo
+     *
+     * @example
+     * ```typescript
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * // Create Core output script for L1 destination
+     * const coreScript = CoreScript.newP2PKH(coreAddressHash);
+     *
+     * const signer = new PlatformAddressSigner();
+     * const platformAddr = signer.addKey(privateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(platformAddr, 0n, 100000n);
+     *
+     * const result = await sdk.addresses.withdraw({
+     *   inputs: [input],
+     *   coreFeePerByte: 1,
+     *   pooling: PoolingWasm.Standard,
+     *   outputScript: coreScript,
+     *   signer
+     * });
+     * ```
+     */
+    async withdraw(options) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.addressFundsWithdraw(options);
+    }
+    /**
+     * Transfer credits from an identity to Platform addresses.
+     *
+     * @param options - Transfer options including identity ID, outputs, and signer
+     * @returns Result with updated address information and new identity balance
+     *
+     * @example
+     * ```typescript
+     * const identityId = Identifier.from("...");
+     * const recipientAddr = PlatformAddress.fromBech32m("tdashevo1...");
+     * const privateKey = PrivateKey.fromWIF("cPrivateKeyWif..."); // Identity transfer key
+     *
+     * const output = new PlatformAddressOutput(recipientAddr, 100000n);
+     *
+     * // Create identity signer and add the transfer key
+     * const signer = new IdentitySigner();
+     * signer.addKey(privateKey);
+     *
+     * const result = await sdk.addresses.transferFromIdentity({
+     *   identityId,
+     *   outputs: [output],
+     *   signer
+     * });
+     *
+     * console.log(`New identity balance: ${result.newBalance}`);
+     * console.log(`Updated addresses:`, result.addressInfos);
+     * ```
+     */
+    async transferFromIdentity(options) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.identityTransferToAddresses(options);
+    }
+    /**
+     * Fund Platform addresses from an asset lock.
+     *
+     * @param options - Funding options including asset lock proof, outputs, and signer
+     * @returns Promise resolving to Map of PlatformAddress to PlatformAddressInfo
+     *
+     * @example
+     * ```typescript
+     * const assetLockPrivateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     * const addressPrivateKey = PrivateKey.fromWIF("cPrivateKeyWif...");
+     *
+     * // Create asset lock proof from L1 transaction
+     * const assetLockProof = AssetLockProof.createInstantAssetLockProof(
+     *   instantLockBytes,
+     *   transactionBytes,
+     *   outputIndex
+     * );
+     *
+     * const signer = new PlatformAddressSigner();
+     * const platformAddr = signer.addKey(addressPrivateKey); // Derives P2PKH address from key
+     *
+     * const output = new PlatformAddressOutput(platformAddr, 100000n);
+     *
+     * const result = await sdk.addresses.fundFromAssetLock({
+     *   assetLockProof,
+     *   assetLockPrivateKey,
+     *   outputs: [output],
+     *   signer
+     * });
+     * ```
+     */
+    async fundFromAssetLock(options) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.addressFundingFromAssetLock(options);
+    }
+    /**
+     * Create an identity funded from Platform addresses.
+     *
+     * @param options - Creation options including identity, inputs, and signers
+     * @returns Promise resolving to result with created identity and updated address infos
+     *
+     * @example
+     * ```typescript
+     * const addressPrivateKey = PrivateKey.fromWIF("cAddressPrivateKeyWif...");
+     * const identityPrivateKey = PrivateKey.fromWIF("cIdentityKeyWif...");
+     *
+     * // Create identity structure with public keys
+     * const identity = new Identity(Identifier.random());
+     * identity.addPublicKey(identityPublicKey);
+     *
+     * // Create signers
+     * const addressSigner = new PlatformAddressSigner();
+     * const sourceAddr = addressSigner.addKey(addressPrivateKey); // Derives P2PKH address from key
+     *
+     * const input = new PlatformAddressInput(sourceAddr, 0n, 100000n);
+     *
+     * const identitySigner = new IdentitySigner();
+     * identitySigner.addKey(identityPrivateKey);
+     *
+     * const result = await sdk.addresses.createIdentity({
+     *   identity,
+     *   inputs: [input],
+     *   identitySigner,
+     *   addressSigner
+     * });
+     *
+     * console.log('Created identity:', result.identity.id());
+     * console.log('Updated addresses:', result.addressInfos);
+     * ```
+     */
+    async createIdentity(options) {
+        const w = await this.sdk.getWasmSdkConnected();
+        return w.identityCreateFromAddresses(options);
+    }
+}

package/dist/dpns/facade.d.ts

@@ -17,8 +17,8 @@ export declare class DpnsFacade {
     }): Promise<wasm.RegisterDpnsNameResult>;
     usernames(query: wasm.DpnsUsernamesQuery): Promise<string[]>;
     username(identityId: wasm.IdentifierLike): Promise<string | undefined>;
-    usernamesWithProof(query: wasm.DpnsUsernamesQuery): Promise<wasm.DpnsUsernamesProofResponse>;
-    usernameWithProof(identityId: wasm.IdentifierLike): Promise<wasm.DpnsUsernameProofResponse>;
+    usernamesWithProof(query: wasm.DpnsUsernamesQuery): Promise<wasm.ProofMetadataResponseTyped<Array<string>>>;
+    usernameWithProof(identityId: wasm.IdentifierLike): Promise<wasm.ProofMetadataResponseTyped<string | null>>;
     getUsernameByName(username: string): Promise<wasm.DpnsUsernameInfo>;
     getUsernameByNameWithProof(username: string): Promise<wasm.ProofMetadataResponseTyped<wasm.DpnsUsernameInfo>>;
 }