cardano_wallet_sdk

Description:

cardano wallet sdk

cardano_wallet_sdk #
SDK for building Cardano blockchain mobile apps in Flutter using the Dart programming language.






Status #
This project started as a Fund 5 Project Catalyst proof-of-concept prototype with limited use-cases. The prototype SDK implements a light-weight client library using the BlockFrost API service for blockchain access and supports loading wallet balances and submitting simple transactions.
Currently this library is being refactored into a production quality Cardano SDK, supporting simple smart contracts, minting, staking, key management and other features needed to write dApps and other types of Cardano clients. This phase is scheduled to be completed in 2022 using a Fund 7 grant.
This is an ambitious project and will require much ongoing maintenance, development and community support. If you'd like to see this project succeed, please support us by voting for the Flutter SDK in Fund 8! This will go towards higher-level smart contract features, backend improvements, third-party dependency reductions, architectural improvements, documentation and tutorials.
If you'd like to can contribute directly, the Flutter SDK has a dedicated wallet:
addr1qx90lkpwhpwu42jnw00w483krjyfvhhpgk97hdfw9nz3xqaqg6dycrrc4qw0l5fsvfgx95gnqmrfxhgrfy8afsxxje5qgplx9r
copied to clipboard
Kick the Tires #
To see the SDK in action, both a pure Dart example and multi-platform Flutter example are incuded in this distribution. You can also visit the live Flutter Demonstration Wallet hosted on google cloud.
Current (Fund 5) Features #

Create Wallets - Create and restore, both read-only and transactional wallets using staking addresses, mnemonics or private keys.
Transaction History - List transactions, rewards and fees for both ADA and Native Tokens.
Addresses - Generate and manage Shelley key pairs and addresses.
Transactions - Build, sign and submit simple ADA payment transactions.
Blockchain API - Cardano blockchain access via the BlockFrost API package
Binary Encoding - Enough CBOR support is provided to submit simple payment transactions.

Usage #
Released versions and installation details can be found on pub.dev.
Coding Style #
Although Dart is an imperative language, the framework uses functional idioms whenever possible. In particular,
the majority of the classes are immutible and rather than creating side effects by throwing
exceptions, the Result class is used. The WalletBuilder's build method
provides a concrete example, returning either a wallet instance or error message if issues arise:
Result<Wallet, String> result = walletBuilder.build();
result.when(
ok: (wallet) => print("Success: ${wallet.walletName}"),
err: (message) => print("Error: $message"),
);
copied to clipboard
Wallet Management #
Create a wallet builder for the testnet using a BlockFrost key.
final walletBuilder = WalletBuilder()
..networkId = NetworkId.testnet
..testnetAdapterKey = blockfrostKey;
copied to clipboard
Create a read-only wallet using a staking address.
var address = ShelleyAddress.fromBech32('stake_test1uqvwl7a...');
final walletBuilder = WalletBuilder()
..networkId = NetworkId.testnet
..testnetAdapterKey = blockfrostKey
..stakeAddress = address;
Result<ReadOnlyWallet, String> result = await walletBuilder.readOnlyBuildAndSync();
result.when(
ok: (wallet) => print("${wallet.walletName}: ${wallet.balance}"),
err: (message) => print("Error: $message"),
);
copied to clipboard
Restore existing wallet using 24 word mnemonic.
List<String> mnemonic = 'rude stadium move gallery receive just...'.split(' ');
final walletBuilder = WalletBuilder()
..networkId = NetworkId.testnet
..testnetAdapterKey = blockfrostKey
..mnemonic = mnemonic;
Result<Wallet, String> result = await walletBuilder.buildAndSync();
if (result.isOk()) {
var wallet = result.unwrap();
print("${wallet.walletName}: ${wallet.balance}");
}
copied to clipboard
Update existing wallet.
final walletBuilder = WalletBuilder()
..networkId = NetworkId.testnet
..testnetAdapterKey = blockfrostKey
..mnemonic = mnemonic;
Result<Wallet, String> result = walletBuilder.build();
Wallet wallet = result.unwrap();
Coin oldBalance = wallet.balance;
var result2 = await wallet.update();
result2.when(
ok: (_) => print("old:$oldBalance lovelace, new: ${wallet.balance} lovelace"),
err: (message) => print("Error: $message"),
);
copied to clipboard
Create a new 24 word mnemonic.
List<String> mnemonic = WalletBuilder.generateNewMnemonic();
print("mnemonic: ${mnemonic.join(' ')}");
copied to clipboard
Wallet Details #
List transaction history.
wallet.transactions.forEach((tx) => print(tx));
copied to clipboard
List addresses.
wallet.addresses.forEach((addr) => print(addr.toBech32()));
copied to clipboard
List currency balances.
final formatter = AdaFormattter.compactCurrency();
wallet.currencies.forEach((assetId, balance) {
final isAda = assetId == lovelaceHex;
print("$assetId: ${isAda ? formatter.format(balance) : balance}");
});
copied to clipboard
List staking rewards.
wallet.stakeAccounts.forEach((acct) {
acct.rewards.forEach((reward) {
print("epoch: ${reward.epoch}, ${reward.amount} ADA");
});
});
copied to clipboard
Wallet Keys and Addresses #
Access root private and public key pair.
Bip32KeyPair pair = wallet.rootKeyPair;
print("${pair.signingKey}, ${pair.verifyKey}");
copied to clipboard
Access staking address.
print(wallet.stakingAddress));
copied to clipboard
First unused change address.
print(wallet.firstUnusedChangeAddress));
copied to clipboard
First unused spend address.
print(wallet.firstUnusedSpendAddress));
copied to clipboard
Submit Transactions #
Send 3 ADA to Bob.
var bobsAddress = ShelleyAddress.fromBech32('addr1qyy6...');
final Result<ShelleyTransaction, String> result = await wallet.sendAda(
toAddress: bobsAddress,
lovelace: 3 * 1000000,
);
if (result.isOk()) {
final tx = result.unwrap();
print("ADA sent. Fee: ${tx.body.fee} lovelace");
}
copied to clipboard
Planned Features #

Smart Contracts - 2022: Consisting of examples and supporting code.
Native Token/NFT - 2022: Provide minting and burning support.
Staking - 2022: Provide stake pool ranking and stake delegation support.
Secure Storage - 2022: Encrypted storage solution for private keys and passwords.
Alternate Addresses - 2022: Support enterprise, pointer and legacy addresses.
Multi-signature - 2023: Support multi-party signatures.
Blockchain Adapter - 2023: Abstraction layer to allow multiple blockchain gateways (i.e. Blockfrost, GraphQL, Ogmios and
Mithril).

Running Integration Tests #
Several of the integration tests (suffixed with '_itest.dart') require a BlockFrost key to run. Installation steps are as follows:

git clone [email protected]:reaster/cardano_wallet_sdk.git
register for a free BlockFrost testnet policy-id key.
paste the policy-id key into a text file named: blockfrost_project_id.txt in the parent directory of this project.

echo "your-project-id" > ../blockfrost_project_id.txt
copied to clipboard
Now you can include the integration tests:
dart test -P itest
copied to clipboard

Copyright 2021 Richard Easterling
SPDX-License-Identifier: Apache-2.0