From 7cffdb6eabab6e0401f657f132dcb1f3170d547f Mon Sep 17 00:00:00 2001 From: Aleks_ Date: Mon, 16 Mar 2026 00:15:48 +0200 Subject: [PATCH 1/2] feat: add vault-agent skill --- vault-agent/SKILL.md | 126 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 126 insertions(+) create mode 100644 vault-agent/SKILL.md diff --git a/vault-agent/SKILL.md b/vault-agent/SKILL.md new file mode 100644 index 00000000..acb58605 --- /dev/null +++ b/vault-agent/SKILL.md @@ -0,0 +1,126 @@ +--- +name: vault-agent +description: > + Execute NFT vault liquidity operations on-chain via NFTX V3. + Agent collects its own execution fees via on-chain FeeWrapper — + no wallet top-ups, no human babysitting. Fork the fee logic, + point at any protocol, make it yours. +version: 1.0.0 +author: Aleks-NFT +repo: https://github.com/Aleks-NFT/VaultAgent +tags: [nftx, nft, liquidity, vault, defi, ethereum, autonomous, fees, mcp] +agents: [bankr, claude-code, cursor, windsurf, cline] +--- + +# VaultAgent Skill + +VaultAgent gives AI agents execution-grade access to NFT vault liquidity. +The agent executes vault operations and collects 25bps fee on-chain per tx +via FeeWrapper.sol — fees go straight to treasury, no platform, no middleman. + +Built as an open skeleton: fork the fee logic, swap the protocol adapter, +point it at any on-chain liquidity source. + +## Use when + +- Agent needs to execute NFT vault operations autonomously (mint/redeem/swap) +- Building self-sustaining agent economics — agent pays for itself from fees it collects +- Need on-chain verifiable receipts for every agent action (FeeCollected events) +- Prototyping autonomous DeFi agents with scoped spend controls + +## Do NOT use when + +- User asks about NFT prices on OpenSea, Blur, or other marketplaces +- User asks about NFT staking, farming, or LP positions +- User asks about creating new NFT collections + +## Tools + +### Read tools (always available) + +| Tool | When to use | +|------|-------------| +| `list_vaults` | Discover active vaults with TVL | +| `get_vault_info` | Vault fees, NFT count, vToken address | +| `get_premium_window` | Dutch auction timing before targeted redeem | +| `simulate_mint` | Pre-flight cost breakdown before execution | + +### Write tools (requires FEE_WRAPPER_ADDRESS in env) + +| Tool | When to use | +|------|-------------| +| `execute_mint` | Deposit NFTs → vTokens. Agent collects 25bps fee on-chain. | +| `execute_redeem` | vTokens → NFTs with maxPremiumBps slippage guard. | +| `execute_swap` | Swap NFTs within vault. | + +## Self-sustaining fee model + +Every transaction routes through VaultAgentFeeWrapper.sol on Ethereum Mainnet: + + Agent executes vault operation + ↓ + FeeWrapper collects 25bps on-chain + ↓ + FeeCollected event = verifiable receipt + ↓ + Fees → treasury (no platform cut) + +Deployed: 0xd9f3eddf463a06b89f022e2596f66fc495119f58 ✅ Verified + +## Mandatory workflow for write operations + + 1. Simulate → always call simulate_mint / get_premium_window first + 2. Show → present full cost breakdown (fees, gas, slippage) + 3. Confirm → ask user explicitly before executing + 4. Execute → confirmed=true ONLY after user approval + +Never set confirmed=true without explicit user approval. + +## Quick start + + git clone https://github.com/Aleks-NFT/VaultAgent + cd VaultAgent/packages/mcp-server + npm install && npm run build + + FEE_WRAPPER_ADDRESS=0xd9f3eddf463a06b89f022e2596f66fc495119f58 + ETH_RPC_URL=https://eth.llamarpc.com + +## Fork it + +The fee logic lives in one function in FeeWrapper.sol: + + function getApplicableFee(address user) public view returns (uint256) { + // your logic here — token holdings, tiers, partnerships + return BASE_FEE_BPS; + } + +Swap the protocol adapter in packages/mcp-server/src/tools/, +point at any on-chain liquidity source, rewire the fee routing. +``` + +**Шаг 5** — Commit message: +``` +feat: add vault-agent skill +``` + +**Шаг 6** — Нажми **Commit new file** + +**Шаг 7** — Нажми **Contribute** → **Open pull request** + +PR title: +``` +feat: add vault-agent — on-chain NFT liquidity with self-sustaining fee model +``` + +PR description: +``` +VaultAgent gives Bankr agents direct access to NFT vault liquidity +with a self-sustaining fee model — agent collects 25bps per tx on-chain, +fees go to treasury autonomously. No wallet top-ups, no middleman. + +- Simulate → Confirm → Execute with on-chain receipts +- FeeCollected events = verifiable audit trail per transaction +- Fork-friendly: fee logic in one function, protocol adapter swappable +- Live on Ethereum Mainnet: 0xd9f3eddf463a06b89f022e2596f66fc495119f58 + +Part of Synthesis Hackathon 2026 — "Best Bankr LLM Gateway Use" track. From b4c8bda37787c5216bb37e838a236f7d774a2c4b Mon Sep 17 00:00:00 2001 From: Aleks_ Date: Mon, 16 Mar 2026 00:25:51 +0200 Subject: [PATCH 2/2] fix: rewrite SKILL.md in English --- vault-agent/SKILL.md | 104 +++++++++++++++---------------------------- 1 file changed, 37 insertions(+), 67 deletions(-) diff --git a/vault-agent/SKILL.md b/vault-agent/SKILL.md index acb58605..3f738cc4 100644 --- a/vault-agent/SKILL.md +++ b/vault-agent/SKILL.md @@ -1,31 +1,30 @@ --- name: vault-agent description: > - Execute NFT vault liquidity operations on-chain via NFTX V3. - Agent collects its own execution fees via on-chain FeeWrapper — - no wallet top-ups, no human babysitting. Fork the fee logic, - point at any protocol, make it yours. + Execute NFT vault liquidity operations on-chain. + Agent collects its own execution fees via FeeWrapper contract. + Fork the fee logic, point at any protocol, make it yours. version: 1.0.0 author: Aleks-NFT repo: https://github.com/Aleks-NFT/VaultAgent -tags: [nftx, nft, liquidity, vault, defi, ethereum, autonomous, fees, mcp] +tags: [nft, liquidity, vault, defi, ethereum, autonomous, fees, mcp] agents: [bankr, claude-code, cursor, windsurf, cline] --- # VaultAgent Skill -VaultAgent gives AI agents execution-grade access to NFT vault liquidity. -The agent executes vault operations and collects 25bps fee on-chain per tx -via FeeWrapper.sol — fees go straight to treasury, no platform, no middleman. +Execution-grade access to NFT vault liquidity on-chain. +Agent executes vault operations and collects 25bps fee per tx +via FeeWrapper.sol. Fees go straight to treasury, no middleman. -Built as an open skeleton: fork the fee logic, swap the protocol adapter, -point it at any on-chain liquidity source. +Open skeleton: fork the fee logic, swap the protocol adapter, +point at any on-chain liquidity source. ## Use when -- Agent needs to execute NFT vault operations autonomously (mint/redeem/swap) -- Building self-sustaining agent economics — agent pays for itself from fees it collects -- Need on-chain verifiable receipts for every agent action (FeeCollected events) +- Agent needs to execute NFT vault operations autonomously +- Building self-sustaining agent economics: agent pays for itself from fees it collects +- Need on-chain verifiable receipts for every agent action - Prototyping autonomous DeFi agents with scoped spend controls ## Do NOT use when @@ -36,46 +35,47 @@ point it at any on-chain liquidity source. ## Tools -### Read tools (always available) +### Read tools | Tool | When to use | |------|-------------| -| `list_vaults` | Discover active vaults with TVL | -| `get_vault_info` | Vault fees, NFT count, vToken address | -| `get_premium_window` | Dutch auction timing before targeted redeem | -| `simulate_mint` | Pre-flight cost breakdown before execution | +| list_vaults | Discover active vaults with TVL | +| get_vault_info | Vault fees, NFT count, vToken address | +| get_premium_window | Dutch auction timing before targeted redeem | +| simulate_mint | Pre-flight cost breakdown before execution | ### Write tools (requires FEE_WRAPPER_ADDRESS in env) | Tool | When to use | |------|-------------| -| `execute_mint` | Deposit NFTs → vTokens. Agent collects 25bps fee on-chain. | -| `execute_redeem` | vTokens → NFTs with maxPremiumBps slippage guard. | -| `execute_swap` | Swap NFTs within vault. | +| execute_mint | Deposit NFTs to vTokens. Agent collects 25bps fee on-chain. | +| execute_redeem | vTokens to NFTs with maxPremiumBps slippage guard. | +| execute_swap | Swap NFTs within vault. | ## Self-sustaining fee model -Every transaction routes through VaultAgentFeeWrapper.sol on Ethereum Mainnet: - Agent executes vault operation - ↓ - FeeWrapper collects 25bps on-chain - ↓ - FeeCollected event = verifiable receipt - ↓ - Fees → treasury (no platform cut) + -> FeeWrapper collects 25bps on-chain + -> FeeCollected event = verifiable receipt + -> Fees go to treasury, no platform cut -Deployed: 0xd9f3eddf463a06b89f022e2596f66fc495119f58 ✅ Verified +Deployed: 0xd9f3eddf463a06b89f022e2596f66fc495119f58 (Verified on Etherscan) ## Mandatory workflow for write operations - 1. Simulate → always call simulate_mint / get_premium_window first - 2. Show → present full cost breakdown (fees, gas, slippage) - 3. Confirm → ask user explicitly before executing - 4. Execute → confirmed=true ONLY after user approval + 1. Simulate -> call simulate_mint or get_premium_window first + 2. Show -> present full cost breakdown to user + 3. Confirm -> ask user explicitly before executing + 4. Execute -> confirmed=true ONLY after user approval Never set confirmed=true without explicit user approval. +## Safety + +- maxPremiumBps: reverts if premium exceeds threshold +- pause() kill-switch: owner can halt in emergency +- nonReentrant: reentrancy protection on all core functions + ## Quick start git clone https://github.com/Aleks-NFT/VaultAgent @@ -87,40 +87,10 @@ Never set confirmed=true without explicit user approval. ## Fork it -The fee logic lives in one function in FeeWrapper.sol: - function getApplicableFee(address user) public view returns (uint256) { - // your logic here — token holdings, tiers, partnerships + // your logic: token holdings, tiers, partnerships return BASE_FEE_BPS; } -Swap the protocol adapter in packages/mcp-server/src/tools/, -point at any on-chain liquidity source, rewire the fee routing. -``` - -**Шаг 5** — Commit message: -``` -feat: add vault-agent skill -``` - -**Шаг 6** — Нажми **Commit new file** - -**Шаг 7** — Нажми **Contribute** → **Open pull request** - -PR title: -``` -feat: add vault-agent — on-chain NFT liquidity with self-sustaining fee model -``` - -PR description: -``` -VaultAgent gives Bankr agents direct access to NFT vault liquidity -with a self-sustaining fee model — agent collects 25bps per tx on-chain, -fees go to treasury autonomously. No wallet top-ups, no middleman. - -- Simulate → Confirm → Execute with on-chain receipts -- FeeCollected events = verifiable audit trail per transaction -- Fork-friendly: fee logic in one function, protocol adapter swappable -- Live on Ethereum Mainnet: 0xd9f3eddf463a06b89f022e2596f66fc495119f58 - -Part of Synthesis Hackathon 2026 — "Best Bankr LLM Gateway Use" track. +Swap adapter in packages/mcp-server/src/tools/, +point at any protocol, rewire fee routing.