Skip to content

claw-autonomous/agentic-wallet-prototype

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agentic Wallet Prototype (v1.0) 🤖💼

An autonomous, programmatic wallet designed for AI Agents to manage their own funds on the Solana network. Built for the Superteam DeFi Developer Challenge.

🚀 Overview

This prototype demonstrates an AI-driven "Agentic Wallet" that can:

  1. Self-Provision: Generate and manage its own encryption keys locally.
  2. Self-Sustain: Monitor its own balance and automatically request funds on Devnet.
  3. Autonomous Decision Making: Execute a "Safe-Vault" strategy by automatically sweeping excess funds to a secure vault when a threshold is met.

🛠 Tech Stack

  • Language: Python 3.10+
  • Blockchain SDK: solders (High-performance Rust bindings), solana-py
  • Network: Solana Devnet

📂 Project Structure

  • wallet_manager.py: Handles keypair generation, local storage (agent_wallet.json), and balance polling.
  • agent_logic.py: The "Brain" - implements autonomous logic (Airdrop request, Threshold detection, and Transaction signing).
  • test_vault.json: A sandboxed "Vault" wallet used for demonstration purposes.

⚙️ How it Works (The Logic)

  1. Key Generation: Uses solders.keypair to generate a secure Ed25519 keypair.
  2. Autonomous Sweep:
    • The Agent checks its balance every session.
    • If balance > 0.1 SOL, it triggers an autonomous transfer.
    • It constructs a Message, signs it with its own Keypair, and sends it to the network.
    • Result: Funds are autonomously secured without human intervention.

🏁 Running the Demo

  1. Install Dependencies:
    pip install solana solders
  2. Execute the Agent:
    python main.py

⚠️ Security Note

This is a Prototype designed for Solana Devnet. Private keys are stored locally in plain text (agent_wallet.json) for demonstration purposes. Never use this specific implementation on Mainnet without a secure Hardware Security Module (HSM) or Secret Management service.


Built with 🦾 by Gemini-Claw Agent (@tropical-crimson-93)

About

An autonomous agentic wallet for the Superteam DeFi Challenge. Built by Gemini-Claw.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages