# setyamickala/fastmint-fcfs-agentic architecture

> Architecture diagram of the GitHub repository setyamickala/fastmint-fcfs-agentic, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/setyamickala/fastmint-fcfs-agentic
- Repository: https://github.com/setyamickala/fastmint-fcfs-agentic

## Overview

fastmint-fcfs is an agent-operated BNB Smart Chain minting skill. The documented workflow checks wallet and RPC readiness, inspects a sale site and contract with recon, rehearses a call, then fire races sale-opening triggers, previews through Binance Agentic Wallet, executes one approved request, and checks its receipt. Source excerpts confirm the core tools and shared helpers; README documents several trigger and reporting details not fully visible in the excerpts.

Main entry points: [`fire.js`](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/fire.js) (Trigger and mint), [`recon.js`](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/recon.js) (Sale recon), [`lib.js`](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/lib.js) (Shared chain helpers), [`SKILL.md`](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/SKILL.md) (Mint skill)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Sale Discovery"]
  node_skill["Mint skill<br/>[SKILL.md]"]
  node_recon["Sale recon<br/>[recon.js]"]
end

subgraph group_execution["Mint Execution"]
  node_fire["Trigger and mint<br/>[fire.js]"]
end

subgraph group_support["Chain and Wallet Support"]
  node_bench["Readiness bench<br/>[bench.js]"]
  node_helpers["Shared chain helpers<br/>[lib.js]"]
end

subgraph group_results["Run Results"]
  node_runs[("Run logs and locks")]
  node_receipt["Transaction receipt"]
end

node_agent(("AI agent"))
node_site["Mint site"]
node_contracts["BSC contracts"]
node_wallet["Binance Agentic Wallet"]
node_rpc["BSC RPC endpoints"]
node_clock["NTP time service"]
node_abi["Sourcify and signatures"]
node_registry["Agent ID registry"]

node_agent -->|"follows workflow"| node_skill
node_agent -->|"checks readiness"| node_bench
node_agent -->|"inspects sale"| node_recon
node_recon -->|"crawls"| node_site
node_recon -->|"probes candidates"| node_contracts
node_recon -->|"uses chain helpers"| node_helpers
node_recon -->|"loads ABI"| node_abi
node_recon -->|"gets wallet address"| node_wallet
node_agent -->|"rehearses and fires"| node_fire
node_fire -->|"uses shared services"| node_helpers
node_fire -->|"previews and executes"| node_wallet
node_fire -->|"simulates call"| node_contracts
node_fire -->|"polls and checks"| node_rpc
node_helpers -->|"races RPC calls"| node_rpc
node_helpers -.->|"syncs clock"| node_clock
node_helpers -->|"fetches ABI and signatures"| node_abi
node_helpers -->|"looks up Agent ID"| node_registry
node_fire -->|"writes logs and locks"| node_runs
node_fire -->|"polls transaction receipt"| node_receipt

click node_skill "https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/SKILL.md"
click node_bench "https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/bench.js"
click node_recon "https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/recon.js"
click node_fire "https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/fire.js"
click node_helpers "https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/lib.js"
click node_runs "https://github.com/setyamickala/fastmint-fcfs-agentic/tree/main/runs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_recon toneBlue
class node_fire toneAmber
class node_bench,node_helpers toneMint
class node_runs,node_receipt toneRose
class node_agent,node_site,node_contracts,node_wallet,node_rpc,node_clock,node_abi,node_registry toneIndigo
```

## Components

### Sale Discovery

- [Mint skill](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/SKILL.md): `SKILL.md`
- [Sale recon](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/recon.js): `recon.js`

### Mint Execution

- [Trigger and mint](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/fire.js): `fire.js`

### Chain and Wallet Support

- [Readiness bench](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/bench.js): `bench.js`
- [Shared chain helpers](https://github.com/setyamickala/fastmint-fcfs-agentic/blob/main/lib.js): `lib.js`

### Run Results

- [Run logs and locks](https://github.com/setyamickala/fastmint-fcfs-agentic/tree/main/runs): `runs`
- **Transaction receipt**

### Other components

- **AI agent**
- **Mint site**
- **BSC contracts**
- **Binance Agentic Wallet**
- **BSC RPC endpoints**
- **NTP time service**
- **Sourcify and signatures**
- **Agent ID registry**

## Connections

- AI agent → Mint skill: follows workflow (evidence: `README.md`)
- AI agent → Readiness bench: checks readiness (evidence: `README.md`)
- AI agent → Sale recon: inspects sale (evidence: `README.md`)
- Sale recon → Mint site: crawls (evidence: `recon.js`)
- Sale recon → BSC contracts: probes candidates (evidence: `recon.js`)
- Sale recon → Shared chain helpers: uses chain helpers (evidence: `recon.js`)
- Sale recon → Sourcify and signatures: loads ABI (evidence: `recon.js`)
- Sale recon → Binance Agentic Wallet: gets wallet address (evidence: `recon.js`)
- AI agent → Trigger and mint: rehearses and fires (evidence: `README.md`)
- Trigger and mint → Shared chain helpers: uses shared services (evidence: `fire.js`)
- Trigger and mint → Binance Agentic Wallet: previews and executes (evidence: `fire.js`)
- Trigger and mint → BSC contracts: simulates call (evidence: `fire.js`)
- Trigger and mint → BSC RPC endpoints: polls and checks (evidence: `fire.js`)
- Shared chain helpers → BSC RPC endpoints: races RPC calls (evidence: `lib.js`)
- Shared chain helpers → NTP time service: syncs clock
- Shared chain helpers → Sourcify and signatures: fetches ABI and signatures (evidence: `lib.js`)
- Shared chain helpers → Agent ID registry: looks up Agent ID (evidence: `lib.js`)
- Trigger and mint → Run logs and locks: writes logs and locks (evidence: `fire.js`)
- Trigger and mint → Transaction receipt: polls transaction receipt (evidence: `fire.js`)