Skip to main content

Wallets

Overview​

Almanak Wallets are fully on-chain, non-custodial wallets secured by Safe and Zodiac. They allow Almanak users to always have full custody and control of their funds, while delegating only the permissions required to execute a strategy to their Deployments.

Architecture​

Almanak Wallets consist of four components:

alt text

  1. User Wallet
  2. Deployment Externally Owned Account (EOA)
  3. Safe Wallet
  4. Zodiac Roles Modifier Module

We discuss each of these components in more detail.

User Wallet​

The User Wallet is the wallet users use to sign into the Almanak platform, and is fully owned by the user. This wallet can be either an externally owned account (EOA) or an on-chain smart account (ERC-4337).

The User Wallet is responsible for managing the Safe Wallet, as well as delegating and revoking permissions to the Deployment EOA.

Deployment EOA​

The Deployment externally owned account (EOA) is a wallet controlled by the Almanak platform. The private key is securely stored and encrypted at rest, with no human being able to access this key at any point in time. The key is used to sign transactions that are being executed by an active strategy.

The Deployment EOA is responsible for signing transactions that are part of an active strategy, as well as payment for the gas required for execution of these transactions.

Safe Wallet​

The Safe Wallet is a smart account built on the Safe technology. It is a 1-out-of-1 multisig wallet where the User Wallet is the sole owner, giving users complete control over their funds. The Safe Wallet integrates with the Zodiac Roles Modifier Module to enable permissioned access for Almanak Deployments while maintaining the non-custodial nature of the wallet.

Zodiac Roles Modifier Module​

The Zodiac Roles Modifier acts as a permission layer between Almanak Deployments and the Safe Wallet. It enables fine-grained access control through:

  • Whitelisting of specific smart contract functions that Deployments can call
  • Parameter restrictions on whitelisted functions to limit the scope of permitted actions
  • Flexible permission management allowing users to specify any deployed contract

Currently, users can create and manage permission sets using the Zodiac SDK locally. A visual permission management interface is under development to make this process more user-friendly.

Security​

Security of user funds is paramount in the Almanak Platform architecture:

  • Deployment EOA private keys are encrypted at rest and can only be accessed by a dedicated signer service
  • Key management utilizes enterprise-grade security infrastructure provided by Google
  • No human access to Deployment EOA private keys is possible at any point

In the unlikely event of a suspected Deployment EOA compromise:

  • Users will be notified immediately through official Almanak communication channels
  • Users should promptly revoke any permissions granted to the compromised EOA
  • A new Deployment EOA will be generated with fresh permissions

Autonomous Execution Fees​

warning

Autonomous Execution Fees are not refundable.

For your Deployment EOAs to operate and execute transactions on the blockchain, you must purchase the Autonomous Execution Service, which is offered on the Almanak Platform.

How the Service Works:

The Autonomous Execution Service covers all operational costs incurred by the Almanak Platform to power your strategies, including the variable network gas fees.

Users are responsible for ensuring they have an active service package to keep their Deployment EOAs operational. New packages can be purchased at any time through the Almanak Platform UI.

Service fees are non-refundable, as they grant immediate access to the Almanak Platform's execution capabilities.

Service fees are paid in the native token of the blockchain where the Deployment EOA is deployed, or in other currencies as offered on the Almanak Platform.

Our service is offered in packages (e.g., for a set number of transactions, or as a time-based subscription). The fee for each package is clearly displayed at the time of purchase.

Applicable taxes, such as VAT, will be added to the service fee.

Future improvements:

The Almanak Platform is developing more efficient service models, including potential cross-chain packages that would allow a single service fee to cover the execution of strategies across multiple blockchains as well as access to other features.