Repolode
Submit
setyamickala

setyamickala/bsc-contract-audit-skill

Two dependency-free agent skills for due diligence on BNB Smart Chain tokens, NFT mints, escrows and bonding-curve token sales, ending in a GO/CAUTION/BLOCK decision.

View on GitHub
Stars
54
Forks
12
Open issues
0
Last commit
4 days ago

What is it?

This repository contains two agent skills for pre-trade due diligence on BNB Smart Chain (chain id 56). The first, bsc-contract-audit, reviews the asset itself: BEP-20 tokens, BEP-721/1155 NFT mints, and deposit-refund allocation escrows. The second, launch-curve-audit, reviews how a token is sold before launch, covering bonding curves, tranche IEOs, admission and escrow logic, graduation with LP custody, and coupled emissions.

The scripts are read-only Python plus curl and jq, and they query chain state over an RPC endpoint. A paid GoPlus key is optional; the stack can run on a BSC RPC, a BscScan or Etherscan key, Sourcify, honeypot.is and the public Binance Web3 audit API. Holder concentration is reconstructed from Transfer logs, and escrow pool integrity is checked by balance queries.

Both skills end with a single line, DECISION: GO | CAUTION | BLOCK, so an agent wallet can gate a buy, swap, mint or lock on it. Each skill maps this line from its own score or verdict, and the stricter result wins when a fast check and a deep audit disagree.

Key features

  • 01Audits BEP-20 tokens, BEP-721/1155 NFT mints and deposit-refund escrows.
  • 02Reviews bonding-curve and tranche IEO sales before launch.
  • 03Reconstructs holder concentration from Transfer logs via rpc.py.
  • 04Checks escrow pool balances for integrity.
  • 05Outputs a machine-readable GO, CAUTION or BLOCK decision.
  • 06Runs read-only with no required paid APIs.

Use cases

  • Gating an agent wallet so it only buys tokens that pass an audit.
  • Checking an NFT mint contract before minting.
  • Verifying that a pre-launch token sale's escrow returns deposits as promised.
  • Reviewing a token launch that moves from bonding curve to LP graduation.

Quick start

  1. 1

    Set a BSC RPC endpoint

    export RPC_URL=https://bsc-rpc.publicnode.com
  2. 2

    Install the asset and escrow auditor skill

    npx skills add setyamickala/bsc-contract-audit-skill/skills/bsc-contract-audit
  3. 3

    Install the sale and bonding-curve auditor skill (optional)

    npx skills add setyamickala/bsc-contract-audit-skill/skills/launch-curve-audit

Things to know

  • Reference only and not investment advice; a clean report does not guarantee safety.
  • Not affiliated with or endorsed by Binance or Anthropic.
  • Requires a shell-capable agent environment such as Claude Code or Cowork.

In collections

Open-source AI agent frameworks & appsSecurity scanners, audits & threat intel tools

Topics

#blockchain#bsc#smart-contract-audit#security#ai-agent#due-diligence#defi

FAQ

What is bsc-contract-audit-skill?
Two dependency-free agent skills for due diligence on BNB Smart Chain tokens, NFT mints, escrows and bonding-curve token sales, ending in a GO/CAUTION/BLOCK decision. This repository contains two agent skills for pre-trade due diligence on BNB Smart Chain (chain id 56). The first, bsc-contract-audit, reviews the asset itself: BEP-20 tokens, BEP-721/1155 NFT mints, and deposit-refund allocation escrows. The second, launch-curve-audit, reviews how a token is sold before launch, covering bonding curves, tranche IEOs, admission and escrow logic, graduation with LP custody, and coupled emissions.
Is bsc-contract-audit-skill free to use? What license does it have?
bsc-contract-audit-skill is open source under the MIT license. Check the license terms before using it in commercial products.
Is bsc-contract-audit-skill still maintained?
Actively maintained. The last commit to bsc-contract-audit-skill was on Nov 4, 2026.
What can I use bsc-contract-audit-skill for?
Gating an agent wallet so it only buys tokens that pass an audit. Checking an NFT mint contract before minting. Verifying that a pre-launch token sale's escrow returns deposits as promised. Reviewing a token launch that moves from bonding curve to LP graduation.
How do I install bsc-contract-audit-skill?
Set a BSC RPC endpoint: export RPC_URL=https://bsc-rpc.publicnode.com Install the asset and escrow auditor skill: npx skills add setyamickala/bsc-contract-audit-skill/skills/bsc-contract-audit Install the sale and bonding-curve auditor skill (optional): npx skills add setyamickala/bsc-contract-audit-skill/skills/launch-curve-audit
Where can I get bsc-contract-audit-skill?
The source code and installation instructions are on GitHub: https://github.com/setyamickala/bsc-contract-audit-skill

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects