The Subaccounts Protocol for Arweave allows users to create and manage sub-wallets (subaccounts) under a master wallet, with accociation of each sub-wallet with the master wallet in a verifiable manner.
This opens up new possibilities for dApps built on the top of Arweave, as they can have full control over wallet for themselves (which means much better UX, no requirement for user confirmation for actions, more flexibility, etc), while maintaining almost full isolation from main account, resulting in flexible, UX firendly and very secure way of interacting with keys.
Each subaccount is essentially a new Arweave wallet, but the private key for each sub-wallet is encrypted using the public key of the master wallet. This means that only the owner of the master wallet's private key can decrypt the sub-wallet's private key. The encrypted sub-wallet private key is then stored on the Arweave network.
In addition, the sub-wallet signs a message stating its association with the master wallet, and this signature can be verified using the sub-wallet's public key. This serves as proof that the real owner of the sub-wallet's private key is claiming association with the master wallet.
yarn add https://prophet.rareweave.store/aQ23JpzbQ-GcPNfD3L-y5VbJOdPV6vN3K5ETqm9byD0
import Subaccounts from 'https://g8way.io/m9MBmC93ZNbr5-t6vDAKu8hChdSQSMqHOWMIwHZQryU/data.js';
Here is an example of how to use the library:
const Arweave = require('arweave');
const Subaccounts = require('arweave-subaccounts');
const arweave = Arweave.init({
host: 'g8way.io',
port: 443,
protocol: 'https',
});
// Create a wallet instance
const wallet = {
/* wallet details */
};
// Create a new instance of Subaccount
const subaccount = new Subaccounts(arweave, wallet);
// Use the subaccount methods
// ! If the address already has one with the same app name it will return previously created one
subaccount
.makeSubaccount('Address', 'AppName')
.then((transaction) => {
console.log('Subaccount creation transaction:', transaction);
})
.catch((error) => {
console.error('Error creating subaccount:', error);
});
The SubAccount
class provides methods for interacting with subaccounts.
The SubAccount
class constructor accepts the following parameters:
arweave
(required): An instance of the Arweave client.wallet
(required): The wallet object containing the necessary keys for creating and decrypting subaccounts. (Typicaly JWK, or web wallet like arweave.app)gqlUrl
(optional): The GraphQL API URL. Default: https://prophet.rareweave.store/graphql
.gateway
(optional): The gateway URL. Default: https://prophet.rareweave.store/
.The fetchSubaccount
method fetches user's subaccount for given app. Subaccount info includes pubkey and encrypted privkey
async fetchSubaccount(address, app);
address
(required): The address of Subaccount being fetchedapp
(required): The app namethe fetchMaster
method retrieves the master address of given subaccount
async fetchMaster(pubkey, app);
pubkey
(required): The Pubkey of Subaccountapp
(required): The app namethe makeSubaccount
method returns the Sub account transaction
async makeSubaccount(address, app);
address
(required): The address of the master walletapp
(required): The app nameThe decrypt
method decrypts subaccount data.
async decrypt(data, options);
data
(required): The encrypted sub account dataapp
(required): The app name