catalyst_cardano 0.1.3 
catalyst_cardano: ^0.1.3 copied to clipboard
projectcatalyst.ioA Flutter plugin exposing the CIP-30 and CIP-95 APIs. Allows to communicate with the Cardano Wallet Extension via js_interop integration.
Content #
Features #
This package implements CIP-30 and CIP-95 APIs which allow the Flutter web app to communicate with the Cardano wallet extension.
In short, the package exposes window.{walletName} JS api taking away all the complexities of using js_interop.
Requirements #
- Dart: 3.3.4+
- Flutter: 3.22.1+
Install #
dependencies:
catalyst_cardano_serialization: any # or the latest version on Pub
catalyst_cardano: any # or the latest version on Pub
catalyst_cardano_web: any # or the latest version on Pub
Web setup #
Add the following line at the end of <head> section in web/index.html:
<script type="module" src="/assets/packages/catalyst_cardano_web/assets/js/catalyst_cardano.js"></script>
Example #
Import package:catalyst_cardano_serialization/catalyst_cardano_serialization.dart
and package:catalyst_cardano/catalyst_cardano.dart, instantiate TransactionBuilder,
provide transaction inputs, outputs, add change address for any remaining unspent UTXOs
and build the transaction body.
To obtain the witnessSet call api.signTx(transaction: unsignedTx);.
Finally, create a signed transaction and submit it
to the blockchain with api.submitTx(transaction: signedTx);
import 'dart:async';
import 'package:catalyst_cardano/catalyst_cardano.dart';
import 'package:catalyst_cardano_serialization/catalyst_cardano_serialization.dart';
Future<void> main() async {
final wallets = await CatalystCardano.instance.getWallets();
if (wallets.isEmpty) {
// no wallet extension found, please install in your browser
return;
}
final wallet = wallets.first;
print(wallet.name);
print(wallet.icon);
print(wallet.apiVersion);
print(wallet.supportedExtensions);
final api = await wallet.enable();
assert(await wallet.isEnabled(), 'wallet is enabled');
print(await api.getBalance());
print(await api.getExtensions());
print(await api.getNetworkId());
print(await api.getRewardAddresses());
print(await api.getUnusedAddresses());
print(await api.getUsedAddresses());
final unsignedTx = _buildUnsignedTx(
utxos: await api.getUtxos(
amount: const Balance(
coin: Coin(1000000),
),
),
changeAddress: await api.getChangeAddress(),
);
final witnessSet = await api.signTx(transaction: unsignedTx);
final signedTx = Transaction(
body: unsignedTx.body,
isValid: true,
witnessSet: witnessSet,
);
await api.submitTx(transaction: signedTx);
}
Transaction _buildUnsignedTx({
required List<TransactionUnspentOutput> utxos,
required ShelleyAddress changeAddress,
}) {
const txBuilderConfig = TransactionBuilderConfig(
feeAlgo: LinearFee(
constant: Coin(155381),
coefficient: Coin(44),
),
maxTxSize: 16384,
maxValueSize: 5000,
coinsPerUtxoByte: Coin(4310),
);
/* cSpell:disable */
final preprodFaucetAddress = ShelleyAddress.fromBech32(
'addr_test1vzpwq95z3xyum8vqndgdd9mdnmafh3djcxnc6jemlgdmswcve6tkw',
);
/* cSpell:enable */
final txOutput = TransactionOutput(
address: preprodFaucetAddress,
amount: const Value(coin: Coin(1000000)),
);
final txBuilder = TransactionBuilder(
config: txBuilderConfig,
inputs: utxos,
networkId: NetworkId.testnet,
);
final txBody = txBuilder
.withOutput(txOutput)
.withChangeAddressIfNeeded(changeAddress)
.buildBody();
return Transaction(
body: txBody,
isValid: true,
witnessSet: const TransactionWitnessSet(vkeyWitnesses: {}),
);
}
Limitations #
This package supports a minimal TransactionBuilder that does not yet work with
Smart Contracts or scripts.
However AuxiliaryMetadata is already supported thus it's possible to fulfill some of the use cases.
NFTs are partially supported, i.e. to transfer them in a transaction.
Only Shelley era bech32 base and stake addresses are supported. Byron era addresses are not supported.
Reference documentation #
- Cardano transaction specification
- Cardano Multiplatform Lib with reference implementation for fee calculation algorithm and change address management.
Support #
Post issues and feature requests on the GitHub issue tracker. Please read our CONTRIBUTING for guidelines on how to contribute.
License #
Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Metadata
Publisher
Metadata
A Flutter plugin exposing the CIP-30 and CIP-95 APIs. Allows to communicate with the Cardano Wallet Extension via js_interop integration.
Repository (GitHub)
View/report issues
Topics
#blockchain #cardano #cryptocurrency #wallet
License
unknown (license)
Dependencies
catalyst_cardano_platform_interface, catalyst_cardano_serialization, catalyst_cardano_web, flutter
