/ArConnect

🦔 Secure wallet management for Arweave

Primary LanguageTypeScriptMIT LicenseMIT

ArConnect

ArConnect is a browser extension allowing Arweave wallet holders to interact with dApps securely and easily.

API

You can interact with basic ArConnect functionalities using arweave-js. To create a transaction, you just don't pass in the user's wallet instance:

const tx = await arweave.createTransaction({
  /* config */
});

Than, you can use ArConnect to add the users wallet to the transaction and sign it (as before, you don't pass in the user's wallet instance, that is done by ArConnect):

await arweave.transactions.sign(tx);

Done! Now you can post the transaction.

Events

ArConnect has some useful custom events.

arweaveWalletLoaded

Triggers when the ArConnect global object (window.arweaveWallet) is injected into the page. It can be useful when executing functions on page load.

window.addEventListener("arweaveWalletLoaded", () => {
  /** Handle ArConnect load event **/
});

walletSwitch

Triggers, when the user switches their wallet in the ArConnect extension popup.

window.addEventListener("walletSwitch", (e) => {
  const newAddress = e.detail.address;
  /** Handle wallet switch **/
});

Requires the ACCESS_ADDRESS and the ACCESS_ALL_ADDRESSES permissions.

Other supported functions

ArConnect supports much more with it's powerful API. These features are not integrated into arweave-js right now, but please let us know if you would like to see them added or not. You can access all of these using the global window.arweaveWallet object (window.arweaveWallet.getActiveAddress(), etc.).

All of these functions are asynchronous, so you will need to await them.

connect(permissions, appInfo?)

Connect to ArConnect and request permissions. This function can always be called again if you want to request more permissions for your site. See the available permissions here.

  • permissions: An array of permissions
  • appInfo: Optional information about your application (see the format)

App info

{
  name?: string; // optional application name
  logo?: string; // optional application logo
}

disconnect()

Disconnect from ArConnect. Removes all permissions from your site.

getActiveAddress()

Get the currently used wallet's address in the extension.

  • returns: A wallet address

Requires the ACCESS_ADDRESS permission.

getAllAddresses(): Promise<string[]>

Get all addresses added to the ArConnect extension

  • returns: A list of the added wallets' addresses.

Requires the ACCESS_ALL_ADDRESSES permission.

getWalletNames(): Promise<{ [addr: string]: string }>

Get wallet names for addresses.

  • returns: An object with addresses and wallet names

Requires the ACCESS_ALL_ADDRESSES permission.

sign(transaction, options?)

Sign a transaction. Raw version of what is used in the arweave-js API.

  • transaction: A valid Arweave transaction without a wallet keyfile added to it
  • options: Arweave signing options
  • returns: Signed transaction instance

Requires the SIGN_TRANSACTION permission.

encrypt(data, options): Promise<Uint8Array>

Encrypt a string, using the user's wallet.

  • data: String to encrypt
  • options: Encrypt options
  • returns: Encrypted string

Requires the ENCRYPT permission.

Encryption options

{
  algorithm: string; // encryption algorithm
  hash: string; // encryption hash
  salt?: string; // optional salt
}

decrypt(data, options): Promise<string>

Decrypt a string encrypted with the user's wallet.

  • data: Uint8Array data to decrypt to a string
  • options: Decrypt options
  • returns: Decrypted string

Requires the DECRYPT permission.

getPermissions()

Get the permissions allowed for you site by the user.

  • returns: A list of permissions allowed for your dApp.

Permissions

There are three permissions currently available. When calling connect, you need to specify at least one of them, preferably ACCESS_ADDRESS.

The permissions:

  • ACCESS_ADDRESS: Access the current address selected in WeaveMask

  • ACCESS_ALL_ADDRESSES: Access all addresses added to WeaveMask

  • SIGN_TRANSACTION: Sign a transaction

  • ENCRYPT: Encrypt data using the user's keyfile

  • DECRYPT: Decrypt data using the user's keyfile

Contributing

Please read the Contributing guide.

License

Licensed under the MIT license.