Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.herd.eco/llms.txt

Use this file to discover all available pages before exploring further.

​
Bookmarks

Two tools for reading and managing the current user’s bookmarks — saved wallets, contracts, and transactions.

​
Get Bookmarks

Fetches all bookmarks for the authenticated user, grouped by type.

​
Returns

  • Contracts — Address, blockchain, contract name, and label
  • Transactions — Hash, blockchain, and label
  • Wallets — Address and label

​
Example Queries

What wallets do I have bookmarked?

Show me my saved contracts

List all my bookmarks

​
Parameters

No input required. Returns bookmarks for the authenticated user.

​
Sample Output

Bookmarks
=========

Contracts (2):
- USDC (ethereum) — 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
- Uniswap V3 Router (base) — 0x2626664c2603336e57b271c5c0b26f421741e481

Transactions (1):
- Aave Deposit — 0xabc123...

Wallets (1):
- My Hot Wallet — 0xdef456...

​
Update Bookmarks

Adds, edits, or removes a single bookmark.

​
Operations

OperationDescription
addSave a new bookmark; auto-generates a label if none is provided
editUpdate the label on an existing bookmark (null to clear)
removeDelete a bookmark

​
Parameters

ParameterRequiredDescription
operationYesadd, edit, or remove
objectTypeYeswallet, contract, or transaction
objectIdYesContract address, transaction hash, or wallet address (0x...)
blockchainConditionalRequired for contract and transaction; omit for wallet. ethereum or base
userLabelNoCustom label. For add: omit to auto-generate. For edit: new label, or null to clear

​
Example Queries

Bookmark vitalik.eth for me

Save contract 0x... on Base as "My Token"

Rename my USDC bookmark to "Circle Stablecoin"

Remove the bookmark for transaction 0x...

​
Bookmark Types

TypeobjectIdblockchain required?
walletWallet addressNo
contractContract addressYes
transactionTransaction hashYes

​
Tips

When adding with no label, a default is generated automatically — e.g. ENS name for wallets, contract name for contracts.
Use getBookmarksTool first to check existing bookmarks before adding duplicates.
  • View wallet details → getWalletOverviewTool
  • View contract details → contractMetadataTool
  • View transaction details → queryTransactionTool

​
Next Steps

Wallet Overview

Profile any wallet address

Contract Metadata

Fetch contract details