@tangle-network/starter-foundry 0.1.0

package/registry/layers/capability/evm-account-abstraction/manifest.json

@@ -0,0 +1,46 @@
+{
+  "id": "evm-account-abstraction",
+  "description": "Specializes a Foundry lane for ERC-4337, gasless minting, and permissionless bundler flows.",
+  "appliesTo": [
+    "forge-contracts"
+  ],
+  "files": [
+    {
+      "source": "files/GaslessCollectible.sol",
+      "target": "src/{{contractName}}.sol"
+    },
+    {
+      "source": "files/GaslessCollectible.t.sol",
+      "target": "test/{{contractName}}.t.sol"
+    },
+    {
+      "source": "files/Deploy.s.sol",
+      "target": "script/Deploy.s.sol"
+    },
+    {
+      "source": "files/MintWithBundler.s.sol",
+      "target": "script/MintWithBundler.s.sol"
+    },
+    {
+      "source": "files/bundler-config.json",
+      "target": "bundler-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "src/{{contractName}}.sol",
+      "script/MintWithBundler.s.sol",
+      "bundler-config.json"
+    ]
+  },
+  "keywords": [
+    "erc-4337",
+    "erc4337",
+    "account abstraction",
+    "bundler",
+    "permissionless.js",
+    "gasless mint",
+    "paymaster",
+    "smart account"
+  ]
+}

package/registry/layers/capability/evm-chain-monitor/files/hooks.mjs

@@ -0,0 +1,14 @@
+export function beforeRequest(snapshot) {
+  return { startedAt: Date.now(), snapshot };
+}
+
+export function formatStats(stats) {
+  return {
+    ...stats,
+    units: {
+      gasPrice: "OKB gwei",
+      tps: "tx/s",
+      blockTime: "seconds",
+    },
+  };
+}

package/registry/layers/capability/evm-chain-monitor/files/monitor-config.json

@@ -0,0 +1,6 @@
+{
+  "stream": "newHeads",
+  "metrics": ["gasPrice", "transactionCount", "blockTime", "tps"],
+  "reconnect": "exponential-backoff",
+  "output": "/stats"
+}

package/registry/layers/capability/evm-chain-monitor/manifest.json

@@ -0,0 +1,31 @@
+{
+  "id": "evm-chain-monitor",
+  "description": "Adds block, gas, and TPS monitoring guidance to the EVM infra starter.",
+  "appliesTo": [
+    "evm-infra-ts"
+  ],
+  "files": [
+    {
+      "source": "files/hooks.mjs",
+      "target": "hooks.mjs"
+    },
+    {
+      "source": "files/monitor-config.json",
+      "target": "monitor-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "hooks.mjs",
+      "monitor-config.json"
+    ]
+  },
+  "keywords": [
+    "block monitor",
+    "gas price",
+    "gas tracker",
+    "tps monitor",
+    "/stats",
+    "chain monitor"
+  ]
+}

package/registry/layers/capability/evm-deploy-foundry/files/Deploy.s.sol

@@ -0,0 +1,11 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import { {{contractName}} } from "../src/{{contractName}}.sol";
+
+contract DeployScript {
+    function run() external returns ({{contractName}} deployed) {
+        // Read PRIVATE_KEY in the real deploy flow, then broadcast against the configured chain.
+        deployed = new {{contractName}}();
+    }
+}

package/registry/layers/capability/evm-deploy-foundry/files/deploy-config.json

@@ -0,0 +1,10 @@
+{
+  "network": "xlayer",
+  "nativeToken": "OKB",
+  "verificationExplorer": "oklink",
+  "env": ["PRIVATE_KEY", "OKLINK_API_KEY"],
+  "notes": [
+    "Bias the agent toward Foundry-based deploy and verify commands.",
+    "Preserve OKB-specific chain assumptions instead of defaulting to ETH."
+  ]
+}

package/registry/layers/capability/evm-deploy-foundry/files/env.example

@@ -0,0 +1,2 @@
+PRIVATE_KEY=0xabc123
+OKLINK_API_KEY=replace-me

package/registry/layers/capability/evm-deploy-foundry/files/foundry.toml

@@ -0,0 +1,13 @@
+[profile.default]
+src = "src"
+out = "out"
+libs = []
+test = "test"
+script = "script"
+
+[rpc_endpoints]
+xlayer_mainnet = "https://rpc.xlayer.tech"
+xlayer_testnet = "https://testrpc.xlayer.tech"
+
+[etherscan]
+xlayer = { key = "${OKLINK_API_KEY}", url = "https://www.oklink.com/api/v5/explorer/contract/verify-source-code-plugin/XLAYER" }

package/registry/layers/capability/evm-deploy-foundry/manifest.json

@@ -0,0 +1,43 @@
+{
+  "id": "evm-deploy-foundry",
+  "description": "Adds chain-aware deploy and verification scaffolding for Foundry-first EVM deployments.",
+  "appliesTo": [
+    "forge-contracts"
+  ],
+  "files": [
+    {
+      "source": "files/foundry.toml",
+      "target": "foundry.toml"
+    },
+    {
+      "source": "files/Deploy.s.sol",
+      "target": "script/Deploy.s.sol"
+    },
+    {
+      "source": "files/deploy-config.json",
+      "target": "deploy-config.json"
+    },
+    {
+      "source": "files/env.example",
+      "target": ".env.example"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "foundry.toml",
+      "script/Deploy.s.sol",
+      "deploy-config.json",
+      ".env.example"
+    ]
+  },
+  "keywords": [
+    "deploy script",
+    "deploy task",
+    "contract verification",
+    "verify",
+    "foundry deploy",
+    "forge deploy",
+    "private_key",
+    ".env template"
+  ]
+}

package/registry/layers/capability/evm-layerzero-oft/files/OmnichainToken.sol

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+contract {{contractName}} {
+    mapping(address => uint256) private balances;
+
+    constructor() {
+        balances[msg.sender] = 1_000_000 ether;
+    }
+
+    function balanceOf(address account) external view returns (uint256) {
+        return balances[account];
+    }
+
+    function sendTokens(uint32 destinationChain, address recipient, uint256 amount) external returns (bytes32 messageId) {
+        require(balances[msg.sender] >= amount, "insufficient balance");
+        balances[msg.sender] -= amount;
+        balances[recipient] += amount;
+        return keccak256(abi.encode(destinationChain, recipient, amount));
+    }
+}

package/registry/layers/capability/evm-layerzero-oft/files/OmnichainToken.t.sol

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import { {{contractName}} } from "../src/{{contractName}}.sol";
+
+contract {{contractName}}Test {
+    {{contractName}} internal token;
+
+    function setUp() public {
+        token = new {{contractName}}();
+    }
+
+    function test_send_tokens_updates_balances() public {
+        address recipient = address(0xBEEF);
+        token.sendTokens(30184, recipient, 100 ether);
+        assert(token.balanceOf(recipient) == 100 ether);
+    }
+}

package/registry/layers/capability/evm-layerzero-oft/files/SendTokens.s.sol

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.24;
+
+import { {{contractName}} } from "../src/{{contractName}}.sol";
+
+contract SendTokensScript {
+    function run({{contractName}} token, uint32 destinationChain, address recipient, uint256 amount) external returns (bytes32) {
+        return token.sendTokens(destinationChain, recipient, amount);
+    }
+}

package/registry/layers/capability/evm-layerzero-oft/files/bridge-config.json

@@ -0,0 +1,10 @@
+{
+  "bridgeProtocol": "layerzero-oft",
+  "sourceChain": "xlayer",
+  "targetChain": "another-evm-chain",
+  "env": ["PRIVATE_KEY"],
+  "notes": [
+    "Keep the omnichain token lane separate from the API/relayer lane.",
+    "Bias the agent toward sendTokens-style bridge scripts."
+  ]
+}

package/registry/layers/capability/evm-layerzero-oft/manifest.json

@@ -0,0 +1,39 @@
+{
+  "id": "evm-layerzero-oft",
+  "description": "Specializes a Foundry contract lane for omnichain token and bridge flows.",
+  "appliesTo": [
+    "forge-contracts"
+  ],
+  "files": [
+    {
+      "source": "files/OmnichainToken.sol",
+      "target": "src/{{contractName}}.sol"
+    },
+    {
+      "source": "files/OmnichainToken.t.sol",
+      "target": "test/{{contractName}}.t.sol"
+    },
+    {
+      "source": "files/SendTokens.s.sol",
+      "target": "script/SendTokens.s.sol"
+    },
+    {
+      "source": "files/bridge-config.json",
+      "target": "bridge-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "src/{{contractName}}.sol",
+      "script/SendTokens.s.sol",
+      "bridge-config.json"
+    ]
+  },
+  "keywords": [
+    "layerzero",
+    "oft",
+    "omnichain fungible token",
+    "bridge tokens",
+    "sendtokens"
+  ]
+}

package/registry/layers/capability/evm-protocol-api/files/protocol-config.json

@@ -0,0 +1,8 @@
+{
+  "scope": "{{protocolScope}}",
+  "role": "{{protocolRole}}",
+  "notes": [
+    "Attach contract indexing, relayer flows, or protocol health logic here.",
+    "This seam is meant for product APIs that support an EVM frontend or contract lane."
+  ]
+}

package/registry/layers/capability/evm-protocol-api/files/protocol-hooks.ts

@@ -0,0 +1,149 @@
+// Types
+
+export interface RawLog {
+  address: string
+  topics: string[]
+  data: string
+  blockNumber: number
+  transactionHash: string
+  logIndex: number
+}
+
+export interface ABIEventInput {
+  name: string
+  type: string
+  indexed: boolean
+}
+
+export interface ABIEvent {
+  name: string
+  inputs: ABIEventInput[]
+}
+
+export interface DecodedEvent {
+  name: string
+  address: string
+  blockNumber: number
+  transactionHash: string
+  logIndex: number
+  args: Record<string, string | bigint>
+}
+
+export interface EventFilter {
+  address?: string
+  topics: (string | null)[]
+  fromBlock: string
+  toBlock: string
+}
+
+// Implementation
+
+function keccak256Hex(input: string): string {
+  // Event signature hashing — in production, use a real keccak256.
+  // This returns a placeholder topic based on the signature string.
+  // Replace with: import { keccak256 } from 'ethereum-cryptography/keccak'
+  // For now, we use Node's crypto as a stand-in for topic matching.
+  const { createHash } = require('crypto') as typeof import('crypto')
+  return '0x' + createHash('sha256').update(input).digest('hex')
+}
+
+function encodeEventSignature(event: ABIEvent): string {
+  const types = event.inputs.map((i) => i.type).join(',')
+  return keccak256Hex(`${event.name}(${types})`)
+}
+
+function decodeABIValue(type: string, hex: string): string | bigint {
+  const cleaned = hex.startsWith('0x') ? hex.slice(2) : hex
+
+  if (type === 'address') {
+    return '0x' + cleaned.slice(-40).toLowerCase()
+  }
+
+  if (type.startsWith('uint') || type.startsWith('int')) {
+    return BigInt('0x' + cleaned)
+  }
+
+  if (type === 'bool') {
+    return BigInt('0x' + cleaned) !== 0n ? 'true' : 'false'
+  }
+
+  if (type.startsWith('bytes')) {
+    return '0x' + cleaned
+  }
+
+  return '0x' + cleaned
+}
+
+export function decodeEventLog(log: RawLog, abi: ABIEvent[]): DecodedEvent | null {
+  if (log.topics.length === 0) return null
+
+  const topicHash = log.topics[0]
+
+  // Match event by topic hash
+  const matchedEvent = abi.find((e) => encodeEventSignature(e) === topicHash)
+  if (!matchedEvent) return null
+
+  const args: Record<string, string | bigint> = {}
+  const indexedInputs = matchedEvent.inputs.filter((i) => i.indexed)
+  const nonIndexedInputs = matchedEvent.inputs.filter((i) => !i.indexed)
+
+  // Decode indexed parameters from topics (topics[1], topics[2], ...)
+  for (let i = 0; i < indexedInputs.length; i++) {
+    const topic = log.topics[i + 1]
+    if (topic) {
+      args[indexedInputs[i].name] = decodeABIValue(indexedInputs[i].type, topic)
+    }
+  }
+
+  // Decode non-indexed parameters from data
+  const data = log.data.startsWith('0x') ? log.data.slice(2) : log.data
+  for (let i = 0; i < nonIndexedInputs.length; i++) {
+    const chunk = data.slice(i * 64, (i + 1) * 64)
+    if (chunk.length > 0) {
+      args[nonIndexedInputs[i].name] = decodeABIValue(nonIndexedInputs[i].type, chunk)
+    }
+  }
+
+  return {
+    name: matchedEvent.name,
+    address: log.address,
+    blockNumber: log.blockNumber,
+    transactionHash: log.transactionHash,
+    logIndex: log.logIndex,
+    args,
+  }
+}
+
+export function buildEventFilter(
+  contractAddress: string,
+  eventSignatures: ABIEvent[],
+  fromBlock: number | 'latest' = 0,
+  toBlock: number | 'latest' = 'latest',
+): EventFilter {
+  const topics = eventSignatures.map((e) => encodeEventSignature(e))
+
+  return {
+    address: contractAddress,
+    topics: [topics.length === 1 ? topics[0] : null],
+    fromBlock: typeof fromBlock === 'number' ? '0x' + fromBlock.toString(16) : fromBlock,
+    toBlock: typeof toBlock === 'number' ? '0x' + toBlock.toString(16) : toBlock,
+  }
+}
+
+export function formatEventForAPI(decodedEvent: DecodedEvent): Record<string, unknown> {
+  // Convert bigints to strings for JSON serialization
+  const serializedArgs: Record<string, string> = {}
+  for (const [key, value] of Object.entries(decodedEvent.args)) {
+    serializedArgs[key] = typeof value === 'bigint' ? value.toString() : value
+  }
+
+  return {
+    event: decodedEvent.name,
+    contract: decodedEvent.address,
+    block: decodedEvent.blockNumber,
+    tx: decodedEvent.transactionHash,
+    logIndex: decodedEvent.logIndex,
+    args: serializedArgs,
+    timestamp: null, // Populated by caller from block data
+  }
+}

package/registry/layers/capability/evm-protocol-api/manifest.json

@@ -0,0 +1,36 @@
+{
+  "id": "evm-protocol-api",
+  "description": "Adds protocol-service seams for EVM relayers, indexers, paymasters, and analytics APIs.",
+  "appliesTo": [
+    "api-service",
+    "evm-infra-ts"
+  ],
+  "defaults": {
+    "protocolRole": "indexer",
+    "protocolScope": "evm"
+  },
+  "files": [
+    {
+      "source": "files/protocol-config.json",
+      "target": "protocol-config.json"
+    },
+    {
+      "source": "files/protocol-hooks.ts",
+      "target": "protocol-hooks.ts"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "protocol-config.json",
+      "protocol-hooks.ts"
+    ]
+  },
+  "keywords": [
+    "indexer",
+    "subgraph",
+    "protocol api",
+    "evm indexer",
+    "event indexer",
+    "relayer api"
+  ]
+}

package/registry/layers/capability/evm-wallet-dashboard/files/hooks.mjs

@@ -0,0 +1,10 @@
+export function beforeRequest(input) {
+  return {
+    address: input.address ?? "0x0000000000000000000000000000000000000000",
+    assets: ["OKB", "USDC", "USDT"],
+  };
+}
+
+export function summarizeBalances(balances) {
+  return balances.map((item) => `${item.symbol}: ${item.amount}`).join("\n");
+}

package/registry/layers/capability/evm-wallet-dashboard/files/wallet-dashboard.json

@@ -0,0 +1,6 @@
+{
+  "mode": "wallet-balance-summary",
+  "nativeCurrency": "OKB",
+  "erc20Assets": ["USDC", "USDT"],
+  "transport": "multicall"
+}

package/registry/layers/capability/evm-wallet-dashboard/manifest.json

@@ -0,0 +1,30 @@
+{
+  "id": "evm-wallet-dashboard",
+  "description": "Adds wallet balance and multicall summary guidance to the EVM infra starter.",
+  "appliesTo": [
+    "evm-infra-ts"
+  ],
+  "files": [
+    {
+      "source": "files/hooks.mjs",
+      "target": "hooks.mjs"
+    },
+    {
+      "source": "files/wallet-dashboard.json",
+      "target": "wallet-dashboard.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "hooks.mjs",
+      "wallet-dashboard.json"
+    ]
+  },
+  "keywords": [
+    "wallet balance",
+    "wallet address",
+    "multicall",
+    "wallet dashboard",
+    "balance dashboard"
+  ]
+}

package/registry/layers/capability/exchange-binance/files/exchange-config.json

@@ -0,0 +1,17 @@
+{
+  "exchange": "{{exchangeName}}",
+  "mode": "{{tradingMode}}",
+  "endpoints": {
+    "rest": "https://api.binance.com",
+    "websocket": "wss://stream.binance.com:9443/ws",
+    "testnet": "https://testnet.binance.vision"
+  },
+  "pairs": ["BTCUSDT", "ETHUSDT"],
+  "rateLimit": { "requestsPerMinute": 1200, "ordersPerSecond": 10 },
+  "features": ["spot", "futures", "margin", "websocket-streams"],
+  "notes": [
+    "Set BINANCE_API_KEY and BINANCE_SECRET in your environment.",
+    "Start with testnet endpoints before going live.",
+    "Rate limits are enforced per IP and per account. Respect both."
+  ]
+}

package/registry/layers/capability/exchange-binance/manifest.json

@@ -0,0 +1,33 @@
+{
+  "id": "exchange-binance",
+  "description": "Adds Binance API integration with spot/futures endpoints, WebSocket market data, and order management.",
+  "appliesTo": [
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "worker-job",
+    "go-worker"
+  ],
+  "defaults": {
+    "exchangeName": "binance",
+    "tradingMode": "spot"
+  },
+  "files": [
+    {
+      "source": "files/exchange-config.json",
+      "target": "exchange-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "exchange-config.json",
+      "strategy.mjs"
+    ]
+  },
+  "keywords": [
+    "binance",
+    "binance api",
+    "binance futures",
+    "binance spot"
+  ]
+}

package/registry/layers/capability/exchange-coinbase/files/exchange-config.json

@@ -0,0 +1,17 @@
+{
+  "exchange": "{{exchangeName}}",
+  "mode": "{{tradingMode}}",
+  "endpoints": {
+    "rest": "https://api.coinbase.com/api/v3/brokerage",
+    "websocket": "wss://advanced-trade-ws.coinbase.com",
+    "sandbox": "https://api-public.sandbox.exchange.coinbase.com"
+  },
+  "pairs": ["BTC-USD", "ETH-USD"],
+  "rateLimit": { "requestsPerSecond": 10 },
+  "features": ["spot", "advanced-trade", "portfolios", "websocket-channels"],
+  "notes": [
+    "Set COINBASE_API_KEY and COINBASE_API_SECRET in your environment.",
+    "Use the sandbox endpoint for testing. Production keys have different permissions.",
+    "Advanced Trade API replaces the legacy Pro API."
+  ]
+}

package/registry/layers/capability/exchange-coinbase/manifest.json

@@ -0,0 +1,33 @@
+{
+  "id": "exchange-coinbase",
+  "description": "Adds Coinbase Advanced Trade API integration with order management, market data, and portfolio tracking.",
+  "appliesTo": [
+    "agent-service-ts",
+    "agent-service-py",
+    "agent-service-rust",
+    "worker-job",
+    "go-worker"
+  ],
+  "defaults": {
+    "exchangeName": "coinbase",
+    "tradingMode": "spot"
+  },
+  "files": [
+    {
+      "source": "files/exchange-config.json",
+      "target": "exchange-config.json"
+    }
+  ],
+  "contextHints": {
+    "extensionPoints": [
+      "exchange-config.json",
+      "strategy.mjs"
+    ]
+  },
+  "keywords": [
+    "coinbase advanced trade",
+    "coinbase exchange",
+    "coinbase pro",
+    "coinbase api trading"
+  ]
+}

package/registry/layers/capability/exchange-okx/files/exchange-config.json

@@ -0,0 +1,17 @@
+{
+  "exchange": "{{exchangeName}}",
+  "mode": "{{tradingMode}}",
+  "endpoints": {
+    "rest": "https://www.okx.com",
+    "websocket": "wss://ws.okx.com:8443/ws/v5",
+    "demo": "https://www.okx.com (with x-simulated-trading header)"
+  },
+  "pairs": ["BTC-USDT", "ETH-USDT"],
+  "rateLimit": { "requestsPerSecond": 20 },
+  "features": ["spot", "futures", "options", "swap", "websocket-channels", "copytrading"],
+  "notes": [
+    "Set OKX_API_KEY, OKX_SECRET, and OKX_PASSPHRASE in your environment.",
+    "Use x-simulated-trading: 1 header for demo mode.",
+    "OKX uses instrument IDs not trading pairs for some endpoints."
+  ]
+}