@moneyos/smart-account

MoneyOS smart-account primitives: everything you need to program, sign for, and submit intents from a MoneyOS smart account.

What's in the box

• Solidity contracts: MoneyOSAccountV1 and MoneyOSAccountFactoryV1 with deterministic CREATE2 deployment.
• EIP-712 IntentV1 types, hashing, and a signer that wraps a viem LocalAccount.
• Signer-scoped nonce lanes (replay-safe) and helpers for idempotency keys.
• Baked network defaults (currently Arbitrum mainnet) for factory, sponsor, and derived smart-account address.
• RelayClient HTTP client for the MoneyOS gasless relay.
• GaslessExecutor that implements ExecutionClient from @moneyos/core and routes calls through the relay.

Install

npm install @moneyos/smart-account

Peer deps: @moneyos/core, viem.

Typical use

import {
  GaslessExecutor,
  RelayClient,
  deriveDefaultGaslessAccount,
  getGaslessNetworkDefaults,
} from "@moneyos/smart-account";

End users of the moneyos CLI don't import this directly — the CLI wires everything up. This package is for SDK consumers, third-party tools, or anyone embedding MoneyOS smart accounts in their own app.

History

This package was previously named @moneyos/gasless and shipped bundled inside the moneyos CLI tarball. Starting with @moneyos/[email protected] it is a standalone package on npm. The name change reflects the fact that "gasless execution" is just one capability built on top of the smart-account primitives; the package now owns the broader smart-account surface.

Tooling

• Contracts: Foundry (forge test)
• SDK: TypeScript + viem (npm run test --workspace=packages/smart-account)

Contracts

• contracts/MoneyOSAccountV1.sol
• contracts/MoneyOSAccountFactoryV1.sol
• contracts/lib/IntentHashV1.sol