flutter_algosigner 0.0.2

A Flutter web plugin to approve or deny Algorand transactions from within your browser using AlgoSigner.

flutter-algosigner

AlgoSigner is a blockchain wallet that makes it easy to use Algorand-based applications on the web. Simply create or import your Algorand account, visit a compatible dApp, and approve or deny transactions — all from within your browser.

AlgoSigner opens the door for developers to build DeFi applications on Algorand by providing a secure way to add transaction capabilities. This enables developers to initiate transactions and accept ALGOs seamlessly, without jeopardizing the security of their users’ secrets.

DApp users can trust AlgoSigner to:

• Securely store and encrypt account secrets
• Authorize transactions without giving dApps direct access to their keys
• Sign and approve transactions when using dApps

The plugin was developed by RootSoft and is not affiliated with PureStake or AlgoSigner is any way. For more information, check out the official AlgoSigner documentation.

Introduction

AlgoSigner injects a JavaScript library into every web page the browser user visits, which allows the site to interact with the extension. The dApp can use the injected library to connect to the user's Wallet, discover account addresses it holds, query the Network (make calls to AlgoD v2 or the Indexer) and request AlgoSigner to request for the user to sign a transaction initiated by the application. All methods of the injected library return a Future that needs to be handled by the dApp.

The flutter-algosigner plugin follows the AlgoSigner API closely and all methods are available. The plugin integrates elegantly with the algorand_dart SDK so transactions can be easily signed and approved.

Once installed, you can simply sign transactions and start sending payments:

await AlgoSigner.connect();

/// Sign the transaction
final txs = await AlgoSigner.signTransaction(
    {
      'txn': transaction.toBase64(),
    },
);

// Send the transaction
final txId = await AlgoSigner.send(
    ledger: 'TestNet',
    transaction: blob,
);

Getting started

Installation

You can install the package via pub.dev:

flutter pub add flutter_algosigner

This will add a line like this to your package's pubspec.yaml (and run an implicit dart pub get):

dependencies:
  flutter_algosigner: ^latest-version

Alternatively, your editor might support flutter pub get. Check the docs for your editor to learn more.

Methods

The flutter-algosigner web plugin wraps the JavaScript API and exposes methods for Flutter developers. This way, Flutter web developers can benefit and create web3 dApplications using the same API.

connect()

Requests access to the Wallet for the dApp, may be rejected or approved. Every access to the extension begins with a connect request, which if approved by the user, allows the dApp to follow-up with other requests.

await AlgoSigner.connect();

accounts()

Returns an array of accounts present in the Wallet for the given Network.

final accounts = await AlgoSigner.accounts(ledger: 'TestNet');

algod()

Proxies the requested path to the Algod v2 API. Is limited to endpoints made available by the API server. By default, all calls to the AlgoSigner.algod method are GET.

await AlgoSigner.algod(
    ledger: 'TestNet',
    path: '/v2/transactions/params',
);

To make a POST requests, more details need to be included in as input.

await AlgoSigner.algod(
    ledger: 'TestNet',
    path: '/v2/teal/compile',
    body: 'int 0',
    method: 'POST',
    contentType: 'text/plain',
);

indexer()

Proxies the requested path to the Indexer v2 API. Is limited to endpoints made available by the API server. The API backend may be configured by advanced users and is not guaranteed to respond as expected. More information can be found here.

await AlgoSigner.indexer(
    ledger: 'TestNet',
    path: '/v2/assets/150821',
);

signTransaction()

Send transaction objects, conforming to the Algorand JS SDK, to AlgoSigner for approval. The Network is determined from the 'genesis-id' property. If approved, the response is an array of signed transaction objects, with the binary blob field base64 encoded to prevent transmission issues.

Transaction Requirements

Transactions objects need to be presented with the following structure:

{
  txn: Base64-encoded string of a transaction binary,
  signers?: [optional] array of addresses to sign with (defaults to the sender),
  multisig?: [optional] extra metadata needed for multisig transactions,
};

For more information, see the transaction requirements

Request

await AlgoSigner.signTransactions(
    [
      {
        'txn': transaction.toBase64(),
      },
    ],
);

Example

The following displays an example on how the algorand-dart SDK can be used to sign transactions with AlgoSigner.

await AlgoSigner.connect();

// Fetch the suggested transaction params
final params = await algorand.getSuggestedTransactionParams();

// Build the transaction
final transaction = await (PaymentTransactionBuilder()
    ..sender = address
    ..note = 'Hi from Flutter'
    ..amount = Algo.toMicroAlgos(0.1)
    ..receiver = address
    ..suggestedParams = params)
  .build();

final txs = await AlgoSigner.signTransactions(
    [
      {
        'txn': transaction.toBase64(),
      },
    ],
);

final blob = txs[0]['blob'];

send()

Send a base64 encoded signed transaction blob to AlgoSigner to transmit to the Network.

final txId = await AlgoSigner.send(
    ledger: 'TestNet',
    transaction: blob,
);

final tx = await algorand.waitForConfirmation(txId);

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing & Pull Requests

Feel free to send pull requests.

Please see CONTRIBUTING for details.

Credits

• Tomas Verhelst
• All Contributors

License

The MIT License (MIT). Please see License File for more information.