Wallet Management

This section covers everything you need to know about creating, selecting, and querying wallets using Evolution-SDK.

Create

You are provided with different methods to create a wallet. Please refer to wallet creation.

Seed Phrase

Generate a new seed phrase (mnemonic).


import { generateSeedPhrase } from "@evolution-sdk/lucid";
 
const seedPhrase = generateSeedPhrase(); // BIP-39
console.log(seedPhrase);

Select

Use any suitable method to select a wallet and interact with the blockchain through it.

Seed Phrase

Select a wallet using a seed phrase (mnemonic).


const seedPhrase = "your seed phrase here ...";
lucid.selectWallet.fromSeed(seedPhrase);

Private Key

Select a wallet using a private key.


lucid.selectWallet.fromPrivateKey(privateKey);

Address

This method will create a limited wallet that can still query the address and its UTxOs. You can use it to build transactions that others will sign, as it cannot sign transactions (no private key).


const address = "addr_test...";
const utxos = await lucid.utxosAt(address);
lucid.selectWallet.fromAddress(address, utxos);

⚠️

Transactions built with an address-only wallet will need to be signed by a wallet with the actual private keys before they can be submitted.

API

If you’re integrating with a wallet provider that exposes an API conforming to the WalletApi interface. This works for any CIP-30 compliant wallet.


const walletApi: WalletApi = externalWalletApi;
lucid.selectWallet.fromAPI(walletApi);

Query

You can fetch data associated with the selected wallet using the following methods.

Address

Get the wallet address. Typically this is the change address.


const address: string = await lucid.wallet().address(); // Bech32 address

UTxOs

Get UTxO associated with the wallet address.


const utxos = await lucid.wallet().getUtxos(); // UTxO[]

Delegation

Query the wallet’s stake delegation status.


const delegation = await lucid.wallet().getDelegation();