{
  "schema_version": "protocol.v1",
  "slug": "railgun",
  "name": "RAILGUN",
  "status": "production-ready",
  "website": "https://railgun.org/",
  "summary": "Onchain zero-knowledge privacy system and SDK for shielding ERC-20 tokens, private transfers, and private DeFi interactions on major EVM chains.",
  "categories": [
    "privacy",
    "zero-knowledge",
    "defi",
    "wallets"
  ],
  "chains": [
    "ethereum",
    "bsc",
    "polygon",
    "arbitrum-one"
  ],
  "best_for": [
    "private token shielding and unshielding",
    "private transfers between 0zk addresses",
    "wallets adding private balances and private DeFi flows"
  ],
  "avoid_for": [
    "apps that only need anonymous group signaling or voting",
    "products that cannot handle compliance, proof-of-innocence, relayer, fee, and user-education requirements"
  ],
  "integration_difficulty": "high",
  "tags": [
    "railgun",
    "privacy",
    "shielding",
    "private-defi",
    "zero-knowledge"
  ],
  "composition": [
    {
      "slug": "kohaku",
      "role": "privacy_layer",
      "direction": "supports",
      "relationship": "Kohaku can use Railgun private token flows as part of wallet privacy tooling and experiments."
    },
    {
      "slug": "uniswap",
      "role": "supporting_protocol",
      "direction": "supports",
      "relationship": "Railgun private DeFi flows can involve swaps and liquidity interactions that eventually touch public AMM liquidity."
    },
    {
      "slug": "privacy-pools",
      "role": "alternative",
      "direction": "alternative",
      "relationship": "Privacy Pools is a related privacy primitive direction focused on association sets and proof-of-innocence concepts."
    }
  ],
  "docs": {
    "url": "https://docs.railgun.org/wiki/",
    "verified_at": "2026-06-04"
  },
  "sdk": {
    "url": "https://github.com/Railgun-Community/engine",
    "verified_at": "2026-06-04"
  },
  "template": {
    "url": "https://ethereum.github.io/kohaku/railgun/intro",
    "verified_at": "2026-06-04"
  },
  "support": {
    "url": "https://railgun.org/wallets",
    "verified_at": "2026-06-04"
  },
  "grant": {
    "url": null,
    "verified_at": "2026-06-04"
  },
  "capabilities": [
    {
      "name": "Shield and unshield ERC-20 tokens",
      "status": "production-ready",
      "type": "integration_workflow",
      "best_for": [
        "wallets that need private token balances",
        "apps that need shielded deposits and withdrawals on existing EVM chains"
      ],
      "known_issues": [
        "Shielding and unshielding require fee, relayer, disclosure, and compliance UX that the app must design."
      ],
      "agent_actions": [
        "recommend_private_token_flow",
        "generate_shielding_checklist"
      ]
    },
    {
      "name": "Private DeFi interactions",
      "status": "production-ready",
      "type": "production_surface",
      "best_for": [
        "private swaps, lending, and dApp calls without leaving the user's preferred chain",
        "wallet-integrated private DeFi"
      ],
      "known_issues": [
        "Builders need to verify adapter support, broadcaster fees, pool liquidity, and proof-of-innocence policy before production."
      ],
      "agent_actions": [
        "recommend_private_defi_stack"
      ]
    }
  ],
  "known_issues": [
    {
      "id": "railgun-fees-and-compliance-ux",
      "title": "RAILGUN integrations need explicit fee, relayer, and compliance UX",
      "description": "RAILGUN supports private transfers and DeFi, but apps must explain shielding/unshielding fees, broadcaster premiums, relayer behavior, compliance posture, and proof-of-innocence expectations.",
      "severity": "medium",
      "status": "confirmed",
      "workaround": "Add explicit user disclosures, fee estimates, broadcaster selection checks, and proof-of-innocence/compliance handling before production.",
      "citations": [
        {
          "url": "https://docs.railgun.org/wiki/",
          "quote": "RAILGUN has 2 main components: RAILGUN-Integrated Wallets... Developer Tools – includes TypeScript SDKs for building RAILGUN privacy into existing/new wallets or a privacy enabled dApp.",
          "retrieved_at": "2026-06-04",
          "confidence": "high",
          "algo": "sha256",
          "content_sha256": "fc5ca9856c6138780eab5210ccdb2465b39ee540671ac19ae53c1424112a4e64"
        },
        {
          "url": "https://ethereum.github.io/kohaku/llms-full.txt",
          "quote": "In addition to the expected network fees (gas fees), there is also a Protocol Fee... and Broadcaster Premium.",
          "retrieved_at": "2026-06-04",
          "confidence": "high",
          "algo": "sha256",
          "content_sha256": "aa6f6a74a2fe8be8c95ccd1ce88e1bb4733ce4df43341828da7e066afbf3354e"
        }
      ]
    }
  ],
  "sources": [
    {
      "label": "RAILGUN docs",
      "url": "https://docs.railgun.org/wiki/",
      "type": "docs"
    },
    {
      "label": "RAILGUN Engine SDK",
      "url": "https://github.com/Railgun-Community/engine",
      "type": "github"
    },
    {
      "label": "Kohaku Railgun docs",
      "url": "https://ethereum.github.io/kohaku/llms-full.txt",
      "type": "docs"
    }
  ],
  "provenance": {
    "verified_at": "2026-06-04",
    "verified_by": "composewith.eth research (RAILGUN docs, Railgun Engine, and Kohaku Railgun docs live-verified via WebFetch 2026-06-04)",
    "confidence": "high"
  },
  "readiness_score": 91,
  "readiness_factors": [
    {
      "key": "docs_present",
      "points": 10,
      "max": 10,
      "detail": "Docs URL present"
    },
    {
      "key": "sdk_present",
      "points": 8,
      "max": 8,
      "detail": "SDK URL present"
    },
    {
      "key": "template_present",
      "points": 6,
      "max": 6,
      "detail": "Template/quickstart present"
    },
    {
      "key": "support_present",
      "points": 6,
      "max": 6,
      "detail": "Support channel present"
    },
    {
      "key": "capability_depth",
      "points": 13,
      "max": 20,
      "detail": "Shield and unshield ERC-20 tokens: integration_workflow; Private DeFi interactions: production_surface"
    },
    {
      "key": "production_capability",
      "points": 15,
      "max": 15,
      "detail": "Has a production-ready capability"
    },
    {
      "key": "provenance_confidence",
      "points": 5,
      "max": 5,
      "detail": "Protocol provenance confidence is high"
    },
    {
      "key": "chain_coverage",
      "points": 8,
      "max": 10,
      "detail": "4 chain(s) (capped at 5)"
    },
    {
      "key": "freshness",
      "points": 10,
      "max": 10,
      "detail": "Last verified 6 day(s) ago"
    },
    {
      "key": "no_open_critical",
      "points": 10,
      "max": 10,
      "detail": "No open critical issues"
    }
  ],
  "readiness_caps": [],
  "scoring_version": "score.v2"
}