Getting Started with QuantumStack
This practical guide walks you through the essential steps to start using QuantumStack. In about 15 minutes, you will have your first NFT created, AGEN activated, and ready to use.
Prerequisites
Before you begin, make sure you have:
- Ethereum Wallet: MetaMask, WalletConnect, or any Ethereum-compatible wallet. We recommend MetaMask for beginners.
- ETH for Gas Fees: You will need ETH to pay transaction fees. We recommend at least 0.01 ETH to start (amounts vary by network and congestion).
- Modern Browser: Chrome, Firefox, Safari, or Edge with Web3 support.
- Internet Connection: Required to interact with the blockchain and IPFS.
Step 1: Connect Wallet
What We Do Here
Connecting your wallet lets QuantumStack identify you and interact with the blockchain on your behalf.
Your wallet is not shared — it only signs transactions when you approve them.
Wallet Connection Flow
┌─────────────────────────────────────┐
│ WALLET CONNECTION FLOW │
└─────────────────────────────────────┘
1. User accesses Dashboard
┌──────────┐
│ User │
└────┬─────┘
│
▼
2. Clicks "Connect Wallet"
┌──────────────┐
│ Dashboard │
└────┬─────────┘
│
▼
3. Selects wallet
┌──────────────┐
│ Wallet │ Requests approval
└────┬─────────┘
│
▼
4. User approves connection
┌──────────────┐
│ Permissions: │
│ • Read │
│ • Sign │
└────┬─────────┘
│
▼
5. Connection established
┌──────────────┐
│ Dashboard │ Shows connected address
└──────────────┘
How to Do It
- Go to the Dashboard: Visit /dashboard on the QuantumStack site
- Click "Connect Wallet": Button in the top-right corner
- Select Your Wallet: Choose MetaMask, WalletConnect, or another available option
- Approve the Connection: Your wallet will ask for approval. Review and approve.
- Confirm Network: Make sure you are on the correct network (Ethereum Mainnet, Polygon, etc.)
Practical Example
John has MetaMask installed. He goes to the dashboard, clicks "Connect Wallet", and selects MetaMask.
MetaMask opens and shows a connection request. John reviews the permissions (read address only, sign transactions) and approves.
The dashboard now shows John's address and he can interact with the system.
Troubleshooting
- Wallet does not appear: Make sure the extension is installed and up to date. Reload the page.
- Network error: Check that you are on the correct network. For testnet, make sure you have test tokens.
- Transaction rejected: Check that you have enough ETH for gas fees.
Step 2: Create Your First NFT
What We Do Here
The NFT is the "constitution" of your agent. It defines all the rules, personality, and capabilities of your AGEN.
This NFT will be unique and will govern your AI agent.
NFT Creation Flow
┌─────────────────────────────────────┐
│ NFT CREATION FLOW │
└─────────────────────────────────────┘
1. User defines settings
┌──────────┐
│ User │ Name, Personality, Limits
└────┬─────┘
│
▼
2. Metadata generated
┌──────────────┐
│ Metadata │ Standard format
└────┬─────────┘
│
▼
3. Upload to storage
┌──────────────────┐
│ Decentralized │ Stores metadata
│ Storage │
└────┬─────────────┘
│
│ Returns unique hash
▼
4. Register on blockchain
┌──────────────┐
│ Blockchain │ NFT contract
└────┬─────────┘
│
▼
5. NFT created
┌──────────────┐
│ NFT │ Linked to user
└────┬─────────┘
│
▼
6. Smart wallet created
┌──────────────┐
│ Smart │ Linked to NFT
│ Wallet │
└──────────────┘
How to Do It
- Go to "Mint NFT": On the dashboard, go to the NFTs section
- Configure Basic Rules:
- Agent Name: What you want to call your AGEN (e.g. "Personal Assistant")
- Personality: Communication style (professional, casual, technical, etc.)
- Transaction Limits: Maximum value per transaction (e.g. 0.1 ETH)
- Allowed Destinations: Addresses the AGEN can send funds to (optional)
- Review Settings: Make sure everything is correct before minting
- Mint NFT: Click "Mint" and approve the transaction in your wallet
- Wait for Confirmation: Wait for the transaction to be confirmed on the blockchain (usually 1–2 minutes)
Descriptive Example
Maria wants to create an AGEN to manage her savings. She configures:
- Name: "Maria Savings"
- Personality: Conservative and cautious
- Per-Transaction Limit: 0.05 ETH (small amounts to start)
- Allowed Destinations: Only known staking addresses
- Modules: Staking and Price Monitoring
Maria reviews the settings, clicks "Mint", and approves the transaction in MetaMask.
After confirmation, she receives NFT #456, which governs her agent "Maria Savings".
What Happens Under the Hood
When you mint an NFT:
- Metadata is created in the standard format
- Metadata is uploaded to IPFS and receives a unique hash
- The hash is recorded on-chain in the NFT contract
- The NFT is minted and linked to your address
- A smart wallet is created for this NFT
Step 3: Activate and Configure Your AGEN
What We Do Here
After creating the NFT, you need to activate the AGEN. The AGEN will read the rules from your NFT and start operating according to them.
How to Do It
- Select Your NFT: On the dashboard, find the NFT you just created
- Click "Activate AGEN": Button on the NFT page
- Wait for Initialization: The system loads rules from IPFS and initializes the AGEN (10–30 seconds)
- Test Communication: Open the chat and send a test message (e.g. "Hello, how are you?")
- Configure Additional Preferences (Optional):
- Voice and tone of communication
- Update frequency
- Notifications and alerts
Descriptive Example
After minting the NFT, Maria clicks "Activate AGEN" for NFT #456.
The system:
- Reads the hash of NFT #456 on-chain
- Fetches full metadata from IPFS using the hash
- Interprets the rules (conservative personality, 0.05 ETH limit, etc.)
- Initializes the AGEN with those rules as context
- Connects the smart wallet created for NFT #456
Maria opens the chat and writes: "Hello, are you active?"
The AGEN replies: "Hello Maria! I'm active and ready. My rules are set: I can execute transactions up to 0.05 ETH to approved destinations. How can I help?"
First Interactions
Now that your AGEN is active, you can:
- Ask Questions: "What is the current price of ETH?" — AGEN fetches and answers
- Request Actions: "Monitor BTC price and notify me if it rises 5%" — AGEN sets up monitoring
- Check Status: "What is my balance?" — AGEN checks wallet and replies
- Set Up Automations: "Stake 50% of my funds when possible" — AGEN proposes action, you approve
Step 4: First Automations
Example: Price Monitoring
You can configure your AGEN to monitor prices and execute actions.
Command: "Monitor the price of ETH. When it drops 5%, buy 0.1 ETH."
Trading Automation Flow
┌─────────────────────────────────────┐
│ TRADING AUTOMATION FLOW │
└─────────────────────────────────────┘
1. User sends command
┌──────────┐
│ User │ Defines strategy and conditions
└────┬─────┘
│
▼
2. Agent receives and interprets
┌──────────┐
│ Agent │ Validates against NFT rules
│ AI │
└────┬─────┘
│
▼
┌─────────┐
│ Value │ Within limits?
│ valid? │
└────┬────┘
│
┌────┴────┐
Yes│ │No
│ │
▼ ▼
┌──────────┐ ┌─────────┐
│ Monitors │ │ Rejects │
│ Market │ │ Outside │
└────┬─────┘ │ limits │
│ └────┬────┘
│ │
▼ │
┌──────────┐ │
│Condition │ │
│ met │ │
└────┬─────┘ │
│ │
▼ │
┌──────────┐ │
│ Proposes │ │
│ Transaction │
└────┬─────┘ │
│ │
▼ │
┌──────────┐ │
│ Wallet │ │
│ Validates │
└────┬─────┘ │
│ │
▼ │
┌──────────┐ │
│ Rules │ │
│ OK? │ │
└────┬─────┘ │
│ │
Yes │
▼ │
┌──────────┐ │
│ Executes │◄────┘
│on-chain │
└────┬─────┘
│
▼
┌──────────────┐
│ Notifies │ User
│ User │
└──────────────┘
What happens:
- AGEN interprets the command and validates against NFT rules
- If within limits (0.1 ETH < configured limit), AGEN accepts
- AGEN sets up price monitoring
- When the condition is met, AGEN proposes a transaction
- Wallet validates the proposal against NFT rules
- If approved, the transaction is executed on-chain
- AGEN notifies you of the execution
Example: Automatic Staking
Set up automatic staking.
Command: "Stake 50% of my funds when there is an opportunity."
What happens:
- AGEN calculates 50% of current balance
- Validates that the amount is within NFT limits
- Looks for available staking opportunities
- Proposes a staking transaction
- You approve (or set auto-approval for small amounts)
- Transaction is executed
Common Use Cases
1. Conservative Automated Trading
Configuration:
- Per-transaction limit: 0.05 ETH
- Strategy: Buy when it drops 5%, sell when it rises 10%
- Daily loss limit: 0.2 ETH
- Allowed destinations: Known DEXs only
Result: AGEN executes trades automatically within the limits you set.
Ensures you never lose more than you configured.
2. Passive Wallet Management
Configuration:
- Automatic staking of 70% of funds
- Monthly rebalancing
- Notifications for significant changes
Result: Wallet is managed automatically.
You get notifications but do not need to interact daily.
3. Personal Finance Assistant
Configuration:
- Personality: Financial advisor
- Portfolio monitoring
- Opportunity alerts
- Trend analysis
Result: AGEN acts as an advisor, analyses the market, and suggests actions.
Always within the limits you defined.
Next Steps
Now that you have the basics working, explore:
- Architecture: Understand how the system works internally
- AGEN Guide: Learn to communicate effectively with your AGEN
- Security: Understand the security measures in place
- White Paper: Read the full technical documentation
Frequently Asked Questions
Can I change the NFT rules later?
Yes. You can update the NFT metadata (rules, personality, etc.) at any time.
The update creates a new version on IPFS and updates the hash on-chain. The AGEN loads the latest version.
What happens if the backend fails?
If the main backend fails, another compatible executor can take over.
Rules are on IPFS and validation is on-chain, so the system keeps working. Your rules and funds remain secure.
Can I have multiple AGENs?
Yes. Each NFT is an independent AGEN.
You can create multiple NFTs for different purposes (trading, staking, personal assistant, etc.).
How much does it cost to use QuantumStack?
You only pay blockchain gas fees (as with any Ethereum transaction). There are no platform fees.
The QST token has transaction fees that are distributed to ecosystem pools.
Last updated: January 2025
Document version: 1.0.0