A shared wallet system built on AO for beacon.

• Usage
• Parent Handlers
  • CreateWallet
• Child Handlers
  • Deploy
  • ProposeTransaction
  • ApproveTransaction
  • Token Deposit
  • Token Withdraw

To deploy a shared wallet, you have two options:

1. Call CreateWallet: You can deploy a shared wallet by calling the CreateWallet handler on the process cOl4yQx_oLBq1c2ZgXcFm9XI2-KT8xlSYzi1IaW5gCQ.

2. Load child.lua: Alternatively, you can deploy your own process by using the .load child.lua command.

   .load child.lua

The parent.lua process is responsible for spawning Shared Wallets (child.lua).

The CreateWallet process initializes a new shared wallet.

• Tags:

  • WalletName: The name of the wallet.
  • Participants: A JSON stringified list of participants.
  • Threshold: The number of approvals required for a transaction.

• Example:

  ao.send({
      Target = "processId",
      Tags = {
          Action = "CreateWallet",
          WalletName = "My Wallet",
          Participants = '["user1", "user2"]',
          Threshold = 2
      }
  })

The child.lua process is the shared wallet. It is responsbile for tracking funds and handling multi-signature transactions.

The Deploy process initializes the wallet with the provided name, threshold, and participants. This function is called only once.

• Tags:

• WalletName: The name of the wallet.

• Participants: A JSON stringified list of participants.

• Threshold: The number of approvals required for a transaction.

• Example:

ao.send({
    Target = "processId",
    Tags = {
        Action = "Deploy",
        WalletName = "My Wallet",
        Participants = '["user1", "user2"]',
        Threshold = 2
    }
})

The ProposeTransaction process allows participants to propose a new transaction.

• Tags:

  • To: The recipient of the transaction.
  • Amount: The amount to be transferred.
  • TokenId: The process ID of the token.

• Example:

  ao.send({
      Target = "processId",
      Tags = {
          Action = "ProposeTransaction",
          To = "recipient",
          Amount = 100,
          TokenId = "token123"
      }
  })

The ApproveTransaction process allows participants to approve or refuse a proposed transaction.

• Tags:

• TxId: The unique identifier of the transaction that needs approval.

• Approved: A boolean value indicating whether the transaction is approved (true) or declined (false).

• Example:

  ao.send({
      Target = "processId",
      Tags = {
          Action = "ApproveTransaction",
          TxId = "tx123",
          Approved = true
      },
      Data = "Approve the transaction."
  })

Resposible for handling token deposits to the wallet. Will add to the tokens table accordingly.

Responsible for handling token withdrawals from the wallet. Will subtract from the tokens table accordingly.

You can run unit tests by running the following command in the root directory:

busted