@elizaos-plugins/plugin-buff

Buff round-up investing plugin for ElizaOS. Auto-invests spare change from every agent transaction into crypto assets via Jupiter on Solana.

Install

npm install @elizaos-plugins/plugin-buff

Configure

Set environment variables:

BUFF_AGENT_SEED=your-32-byte-hex-seed   # Deterministic wallet (optional — generates random if not set)
BUFF_PLAN=sprout                         # seed|sprout|tree|forest
BUFF_INVEST_INTO=BTC                     # BTC|ETH|SOL|USDC
BUFF_THRESHOLD=5                         # USD threshold before auto-swap

Add to your character

{
  "name": "my-agent",
  "plugins": ["@elizaos-plugins/plugin-buff"]
}

Actions

Action	Trigger	Description
BUFF_ROUNDUP	"round up my $4.73 transaction"	Record a round-up
BUFF_INVEST	"check my Buff investments"	Check threshold & auto-invest
BUFF_PORTFOLIO	"show my Buff portfolio"	View invested assets
BUFF_SET_PLAN	"set plan to tree"	Change round-up tier
BUFF_SET_ALLOC	"set allocation 60% BTC 40% ETH"	Set portfolio split

Provider

The buffPortfolioProvider automatically injects portfolio context into agent conversations, so the agent knows its investment status.

How It Works

1. Agent makes transactions (swaps, API calls, payments)
2. Each transaction is rounded up to the nearest increment
3. Spare change accumulates in the agent's Buff wallet
4. When threshold is reached → auto-swap to BTC/ETH via Jupiter
5. Agent builds a crypto portfolio passively

Links

• Buff Docs
• Buff Dashboard
• GitHub

License

MIT