@star-factory/sdk-launchpad 0.1.0 → 0.1.1

package/dist/idl/launchpad.json

@@ -0,0 +1,2892 @@
+{
+  "address": "GdmC9tCxEvCLF3affN1mSEiLbowm5qKbJzfHSm1yyEDU",
+  "metadata": {
+    "name": "launchpad",
+    "version": "0.1.0",
+    "spec": "0.1.0",
+    "description": "Star Vault Launchpad Program"
+  },
+  "instructions": [
+    {
+      "name": "admin_sweep_dust",
+      "docs": [
+        "Sweep remaining tokens (rounding dust) from token_vault to DAO treasury.",
+        "Only valid after launch + grace period (180 days)."
+      ],
+      "discriminator": [
+        131,
+        100,
+        94,
+        232,
+        197,
+        203,
+        4,
+        19
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Platform admin signer."
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config (must be in Launched state)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  108,
+                  97,
+                  117,
+                  110,
+                  99,
+                  104
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.creator",
+                "account": "LaunchConfig"
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.seed",
+                "account": "LaunchConfig"
+              }
+            ]
+          }
+        },
+        {
+          "name": "launchpad_signer",
+          "docs": [
+            "The launchpad signer PDA (signs the transfer)."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  105,
+                  103,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "base_mint",
+          "docs": [
+            "The base mint of the launched token."
+          ]
+        },
+        {
+          "name": "token_vault",
+          "docs": [
+            "Token vault: ATA of launchpad_signer for base_mint (source of dust)."
+          ],
+          "writable": true
+        },
+        {
+          "name": "destination",
+          "docs": [
+            "Destination: DAO treasury token account for base_mint."
+          ],
+          "writable": true
+        },
+        {
+          "name": "token_program"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "cancel_launch",
+      "docs": [
+        "Cancel a launch from any pre-Launched state.",
+        "Burns tokens if minted, enables refunds on the vault.",
+        "Transitions to Cancelled."
+      ],
+      "discriminator": [
+        120,
+        69,
+        17,
+        7,
+        41,
+        48,
+        40,
+        37
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Platform admin signer."
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config to cancel."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  108,
+                  97,
+                  117,
+                  110,
+                  99,
+                  104
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.creator",
+                "account": "LaunchConfig"
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.seed",
+                "account": "LaunchConfig"
+              }
+            ]
+          }
+        },
+        {
+          "name": "launchpad_signer",
+          "docs": [
+            "The launchpad signer PDA (signs burn/authority operations if token exists)."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  105,
+                  103,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "base_mint",
+          "docs": [
+            "The base mint (optional — only needed if state == TokenCreated)."
+          ],
+          "writable": true,
+          "optional": true
+        },
+        {
+          "name": "token_vault",
+          "docs": [
+            "Token vault: ATA of launchpad_signer for base_mint (optional)."
+          ],
+          "writable": true,
+          "optional": true
+        },
+        {
+          "name": "fundraise_state",
+          "docs": [
+            "The vault account (fundraise state) — for CPI to initiate_refund."
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_program",
+          "docs": [
+            "The vault program for CPI."
+          ],
+          "address": "2izCb6E5VNBa8NMFnKZhDmBptMCv7TyUNjkwFwrvf44B"
+        },
+        {
+          "name": "token_program"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "claim_tokens",
+      "docs": [
+        "Claim vested tokens based on user's vault allocation and tier.",
+        "Vesting starts at pool_activation_time, linear over tier duration.",
+        "Can be called multiple times as vesting progresses."
+      ],
+      "discriminator": [
+        108,
+        216,
+        210,
+        231,
+        0,
+        212,
+        42,
+        64
+      ],
+      "accounts": [
+        {
+          "name": "user",
+          "docs": [
+            "The user claiming their vested tokens."
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config (must be in Launched state)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  108,
+                  97,
+                  117,
+                  110,
+                  99,
+                  104
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.creator",
+                "account": "LaunchConfig"
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.seed",
+                "account": "LaunchConfig"
+              }
+            ]
+          }
+        },
+        {
+          "name": "fundraise_state",
+          "docs": [
+            "The vault account (read-only). Used to read total_allocated and tier info."
+          ],
+          "relations": [
+            "launch_config"
+          ]
+        },
+        {
+          "name": "user_record",
+          "docs": [
+            "The user's depositor record (read-only). Used to read allocation and tier."
+          ]
+        },
+        {
+          "name": "claim_record",
+          "docs": [
+            "Per-user claim record (init_if_needed on first claim)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  99,
+                  108,
+                  97,
+                  105,
+                  109
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              },
+              {
+                "kind": "account",
+                "path": "user"
+              }
+            ]
+          }
+        },
+        {
+          "name": "base_mint",
+          "docs": [
+            "The base mint of the launched token."
+          ]
+        },
+        {
+          "name": "token_vault",
+          "docs": [
+            "Token vault: holds tokens_to_participants (ATA of launchpad_signer for base_mint)."
+          ],
+          "writable": true
+        },
+        {
+          "name": "user_token_ata",
+          "docs": [
+            "User's ATA for the base mint (receives claimed tokens)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "user"
+              },
+              {
+                "kind": "const",
+                "value": [
+                  6,
+                  221,
+                  246,
+                  225,
+                  215,
+                  101,
+                  161,
+                  147,
+                  217,
+                  203,
+                  225,
+                  70,
+                  206,
+                  235,
+                  121,
+                  172,
+                  28,
+                  180,
+                  133,
+                  237,
+                  95,
+                  91,
+                  55,
+                  145,
+                  58,
+                  140,
+                  245,
+                  133,
+                  126,
+                  255,
+                  0,
+                  169
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "base_mint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "launchpad_signer",
+          "docs": [
+            "The launchpad signer PDA (signs transfers from token_vault)."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  105,
+                  103,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "token_program"
+        },
+        {
+          "name": "associated_token_program",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "configure_launch",
+      "docs": [
+        "Set vanity mint configuration and token metadata.",
+        "Transitions from FundraiseActive → ReadyToLaunch.",
+        "Requires vault.status == TgeRequested (creator called request_tge)."
+      ],
+      "discriminator": [
+        4,
+        9,
+        63,
+        61,
+        104,
+        54,
+        141,
+        228
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Platform admin signer."
+          ],
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config to update (must be in FundraiseActive state)."
+          ],
+          "writable": true
+        },
+        {
+          "name": "fundraise_state",
+          "docs": [
+            "The vault account (read-only). Must be in TgeRequested status.",
+            "Deserialized as StarVault to validate vault.status."
+          ],
+          "relations": [
+            "launch_config"
+          ]
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "ConfigureLaunchArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "create_launch_token",
+      "docs": [
+        "Create the vanity mint, Metaplex metadata, and mint total supply.",
+        "Transitions from ReadyToLaunch → TokenCreated.",
+        "Requires both admin and base_keypair to sign."
+      ],
+      "discriminator": [
+        217,
+        214,
+        222,
+        31,
+        171,
+        74,
+        29,
+        213
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Platform admin signer (pays rent for mint + metadata)."
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "base_keypair",
+          "docs": [
+            "Base keypair that was used to derive the vanity mint address.",
+            "Must match launch_config.vanity_config.base_pubkey."
+          ],
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config (must be ReadyToLaunch)."
+          ],
+          "writable": true
+        },
+        {
+          "name": "launchpad_signer",
+          "docs": [
+            "The launchpad signer PDA — will be the mint authority."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  105,
+                  103,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint",
+          "docs": [
+            "The vanity mint — will be created by this instruction."
+          ],
+          "writable": true
+        },
+        {
+          "name": "metadata",
+          "docs": [
+            "Metaplex metadata PDA for the mint."
+          ],
+          "writable": true
+        },
+        {
+          "name": "token_vault",
+          "docs": [
+            "Token vault: ATA of launchpad_signer for the new mint.",
+            "Receives all minted tokens. Created manually after mint is created."
+          ],
+          "writable": true
+        },
+        {
+          "name": "metadata_program",
+          "docs": [
+            "Metaplex Token Metadata program."
+          ],
+          "address": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"
+        },
+        {
+          "name": "token_program"
+        },
+        {
+          "name": "associated_token_program",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        },
+        {
+          "name": "rent",
+          "address": "SysvarRent111111111111111111111111111111111"
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "execute_launch",
+      "docs": [
+        "Execute the full launch: vault finalization, DAMM pool creation,",
+        "DAO creation via futarchy, authority transfers, and fund routing.",
+        "Transitions from TokenCreated → Launched.",
+        "This is the most complex instruction — all steps are atomic."
+      ],
+      "discriminator": [
+        173,
+        237,
+        210,
+        57,
+        212,
+        147,
+        246,
+        53
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Platform admin signer. Pays rent, signs vault CPI, creates DAO."
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config (must be in TokenCreated state)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  108,
+                  97,
+                  117,
+                  110,
+                  99,
+                  104
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.creator",
+                "account": "LaunchConfig"
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.seed",
+                "account": "LaunchConfig"
+              }
+            ]
+          }
+        },
+        {
+          "name": "launchpad_signer",
+          "docs": [
+            "The launchpad signer PDA — controls token_vault, funds_vault, mint authority."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  105,
+                  103,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "base_mint",
+          "docs": [
+            "The launched token's mint (base_mint). Mutable for set_authority."
+          ],
+          "writable": true
+        },
+        {
+          "name": "quote_mint",
+          "docs": [
+            "Quote mint (wSOL or USDC)."
+          ]
+        },
+        {
+          "name": "launchpad_token_vault",
+          "docs": [
+            "Token vault: ATA of launchpad_signer for base_mint.",
+            "Holds total_supply after create_launch_token; will hold tokens_to_participants post-execute."
+          ],
+          "writable": true
+        },
+        {
+          "name": "launchpad_funds_vault",
+          "docs": [
+            "Funds vault: ATA of launchpad_signer for quote_mint.",
+            "Receives funds from vault::accept_and_calculate."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "launchpad_signer"
+              },
+              {
+                "kind": "const",
+                "value": [
+                  6,
+                  221,
+                  246,
+                  225,
+                  215,
+                  101,
+                  161,
+                  147,
+                  217,
+                  203,
+                  225,
+                  70,
+                  206,
+                  235,
+                  121,
+                  172,
+                  28,
+                  180,
+                  133,
+                  237,
+                  95,
+                  91,
+                  55,
+                  145,
+                  58,
+                  140,
+                  245,
+                  133,
+                  126,
+                  255,
+                  0,
+                  169
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "admin_token_ata",
+          "docs": [
+            "Admin's ATA for base_mint (receives team tokens)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "admin"
+              },
+              {
+                "kind": "const",
+                "value": [
+                  6,
+                  221,
+                  246,
+                  225,
+                  215,
+                  101,
+                  161,
+                  147,
+                  217,
+                  203,
+                  225,
+                  70,
+                  206,
+                  235,
+                  121,
+                  172,
+                  28,
+                  180,
+                  133,
+                  237,
+                  95,
+                  91,
+                  55,
+                  145,
+                  58,
+                  140,
+                  245,
+                  133,
+                  126,
+                  255,
+                  0,
+                  169
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "base_mint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "fundraise_state",
+          "docs": [
+            "The fundraise vault account (StarVault PDA)."
+          ],
+          "writable": true
+        },
+        {
+          "name": "tge_config",
+          "docs": [
+            "Vault TGE config PDA."
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_ata",
+          "docs": [
+            "Vault's quote token ATA (source of funds)."
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_program",
+          "docs": [
+            "The vault program for CPI."
+          ],
+          "address": "2izCb6E5VNBa8NMFnKZhDmBptMCv7TyUNjkwFwrvf44B"
+        },
+        {
+          "name": "position_nft_mint",
+          "docs": [
+            "Position NFT mint — PDA of launchpad program, acts as signer for DAMM CPI."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  112,
+                  111,
+                  115,
+                  105,
+                  116,
+                  105,
+                  111,
+                  110,
+                  95,
+                  110,
+                  102,
+                  116,
+                  95,
+                  109,
+                  105,
+                  110,
+                  116
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "position_nft_account",
+          "docs": [
+            "Position NFT token account — PDA of DAMM program."
+          ],
+          "writable": true
+        },
+        {
+          "name": "damm_pool_authority",
+          "docs": [
+            "DAMM pool authority — PDA of DAMM program."
+          ]
+        },
+        {
+          "name": "damm_pool",
+          "docs": [
+            "DAMM pool account — created by DAMM program."
+          ],
+          "writable": true
+        },
+        {
+          "name": "damm_position",
+          "docs": [
+            "DAMM position account — PDA of DAMM program."
+          ],
+          "writable": true
+        },
+        {
+          "name": "damm_token_a_vault",
+          "docs": [
+            "DAMM token A vault (base_mint) — PDA of DAMM program."
+          ],
+          "writable": true
+        },
+        {
+          "name": "damm_token_b_vault",
+          "docs": [
+            "DAMM token B vault (quote_mint) — PDA of DAMM program."
+          ],
+          "writable": true
+        },
+        {
+          "name": "damm_event_authority",
+          "docs": [
+            "DAMM event authority — PDA of DAMM program."
+          ]
+        },
+        {
+          "name": "damm_program",
+          "docs": [
+            "DAMM v2 program."
+          ],
+          "address": "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG"
+        },
+        {
+          "name": "dao",
+          "docs": [
+            "DAO account — PDA of futarchy program, seeds=[\"dao\", name]."
+          ],
+          "writable": true
+        },
+        {
+          "name": "moderator",
+          "docs": [
+            "Moderator account — PDA of futarchy program, seeds=[\"moderator\", name]."
+          ],
+          "writable": true
+        },
+        {
+          "name": "futarchy_program_config",
+          "docs": [
+            "Squads program config — read by futarchy."
+          ]
+        },
+        {
+          "name": "futarchy_program_config_treasury",
+          "docs": [
+            "Squads program config treasury — receives squads creation fee."
+          ],
+          "writable": true
+        },
+        {
+          "name": "treasury_multisig",
+          "docs": [
+            "Treasury multisig — created by futarchy via squads CPI."
+          ],
+          "writable": true
+        },
+        {
+          "name": "mint_multisig",
+          "docs": [
+            "Mint authority multisig — created by futarchy via squads CPI."
+          ],
+          "writable": true
+        },
+        {
+          "name": "mint_create_key",
+          "docs": [
+            "Mint create key — PDA of futarchy, seeds=[dao, \"mint_key\", name]."
+          ]
+        },
+        {
+          "name": "squads_program",
+          "docs": [
+            "Squads v4 program."
+          ]
+        },
+        {
+          "name": "futarchy_program",
+          "docs": [
+            "Futarchy program."
+          ],
+          "address": "FUTKPrt66uGGCTpk6f9tmRX2325cWgXzGCwvWhyyzjea"
+        },
+        {
+          "name": "new_dao_admin",
+          "docs": [
+            "ZC-managed admin wallet — becomes the DAMM pool `creator` (LP position NFT owner)",
+            "and the futarchy DAO admin after `transfer_admin`."
+          ]
+        },
+        {
+          "name": "dao_treasury",
+          "docs": [
+            "DAO treasury vault (Squads vault PDA of treasury_multisig) — receives 80% funds."
+          ]
+        },
+        {
+          "name": "dao_treasury_quote_ata",
+          "docs": [
+            "DAO treasury's ATA for quote_mint — receives 80% of raised funds."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "account",
+                "path": "dao_treasury"
+              },
+              {
+                "kind": "const",
+                "value": [
+                  6,
+                  221,
+                  246,
+                  225,
+                  215,
+                  101,
+                  161,
+                  147,
+                  217,
+                  203,
+                  225,
+                  70,
+                  206,
+                  235,
+                  121,
+                  172,
+                  28,
+                  180,
+                  133,
+                  237,
+                  95,
+                  91,
+                  55,
+                  145,
+                  58,
+                  140,
+                  245,
+                  133,
+                  126,
+                  255,
+                  0,
+                  169
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "quote_mint"
+              }
+            ],
+            "program": {
+              "kind": "const",
+              "value": [
+                140,
+                151,
+                37,
+                143,
+                78,
+                36,
+                137,
+                241,
+                187,
+                61,
+                16,
+                41,
+                20,
+                142,
+                13,
+                131,
+                11,
+                90,
+                19,
+                153,
+                218,
+                255,
+                16,
+                132,
+                4,
+                142,
+                123,
+                216,
+                219,
+                233,
+                248,
+                89
+              ]
+            }
+          }
+        },
+        {
+          "name": "metadata",
+          "docs": [
+            "Metaplex metadata account for the base mint."
+          ],
+          "writable": true
+        },
+        {
+          "name": "metadata_program",
+          "docs": [
+            "Metaplex Token Metadata program."
+          ],
+          "address": "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s"
+        },
+        {
+          "name": "token_program"
+        },
+        {
+          "name": "token_2022_program",
+          "docs": [
+            "Token-2022 program (required by DAMM for NFT mint)."
+          ],
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "associated_token_program",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "ExecuteLaunchArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "initialize_launch",
+      "docs": [
+        "Create a new launch config and the underlying fundraise vault via CPI.",
+        "Creator signs as both the launch initiator and the vault maker."
+      ],
+      "discriminator": [
+        90,
+        201,
+        220,
+        142,
+        112,
+        253,
+        100,
+        13
+      ],
+      "accounts": [
+        {
+          "name": "creator",
+          "docs": [
+            "The creator initiating the launch. Also the maker/authority of the vault."
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "Launch config PDA — the main account for this launch."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  108,
+                  97,
+                  117,
+                  110,
+                  99,
+                  104
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "creator"
+              },
+              {
+                "kind": "arg",
+                "path": "args.seed"
+              }
+            ]
+          }
+        },
+        {
+          "name": "launchpad_signer",
+          "docs": [
+            "Launchpad signer PDA — derived from launch_config.",
+            "Controls token_vault, funds_vault, and mint authority."
+          ],
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  115,
+                  105,
+                  103,
+                  110,
+                  101,
+                  114
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config"
+              }
+            ]
+          }
+        },
+        {
+          "name": "quote_mint",
+          "docs": [
+            "The quote mint (wSOL or USDC) for this launch."
+          ]
+        },
+        {
+          "name": "vault",
+          "docs": [
+            "The vault account — will be created via CPI to vault::make."
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_ata",
+          "docs": [
+            "The vault's quote token ATA — will be created via CPI."
+          ],
+          "writable": true
+        },
+        {
+          "name": "tge_config",
+          "docs": [
+            "TGE config — will be created via CPI."
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_program",
+          "docs": [
+            "The vault program for CPI."
+          ],
+          "address": "2izCb6E5VNBa8NMFnKZhDmBptMCv7TyUNjkwFwrvf44B"
+        },
+        {
+          "name": "associated_token_program",
+          "address": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL"
+        },
+        {
+          "name": "token_program"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "InitializeLaunchArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "update_launch_config",
+      "docs": [
+        "Recovery instruction: update vanity mint config if admin loses base_keypair",
+        "before token creation. Only valid from ReadyToLaunch state."
+      ],
+      "discriminator": [
+        90,
+        247,
+        161,
+        188,
+        203,
+        181,
+        147,
+        240
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Platform admin signer."
+          ],
+          "signer": true
+        },
+        {
+          "name": "launch_config",
+          "docs": [
+            "The launch config to update (must be in ReadyToLaunch state)."
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  108,
+                  97,
+                  117,
+                  110,
+                  99,
+                  104
+                ]
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.creator",
+                "account": "LaunchConfig"
+              },
+              {
+                "kind": "account",
+                "path": "launch_config.seed",
+                "account": "LaunchConfig"
+              }
+            ]
+          }
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "UpdateLaunchConfigArgs"
+            }
+          }
+        }
+      ]
+    }
+  ],
+  "accounts": [
+    {
+      "name": "ClaimRecord",
+      "discriminator": [
+        57,
+        229,
+        0,
+        9,
+        65,
+        62,
+        96,
+        7
+      ]
+    },
+    {
+      "name": "DepositorRecord",
+      "discriminator": [
+        2
+      ]
+    },
+    {
+      "name": "LaunchConfig",
+      "discriminator": [
+        18,
+        161,
+        9,
+        224,
+        102,
+        145,
+        29,
+        94
+      ]
+    },
+    {
+      "name": "StarVault",
+      "discriminator": [
+        1
+      ]
+    }
+  ],
+  "events": [
+    {
+      "name": "DustSweptEvent",
+      "discriminator": [
+        135,
+        231,
+        54,
+        37,
+        252,
+        173,
+        171,
+        101
+      ]
+    },
+    {
+      "name": "LaunchCancelledEvent",
+      "discriminator": [
+        118,
+        248,
+        203,
+        227,
+        193,
+        105,
+        152,
+        59
+      ]
+    },
+    {
+      "name": "LaunchConfigUpdatedEvent",
+      "discriminator": [
+        224,
+        19,
+        110,
+        152,
+        144,
+        149,
+        111,
+        95
+      ]
+    },
+    {
+      "name": "LaunchConfiguredEvent",
+      "discriminator": [
+        170,
+        93,
+        79,
+        96,
+        80,
+        145,
+        69,
+        89
+      ]
+    },
+    {
+      "name": "LaunchExecutedEvent",
+      "discriminator": [
+        252,
+        67,
+        56,
+        205,
+        207,
+        136,
+        144,
+        96
+      ]
+    },
+    {
+      "name": "LaunchInitializedEvent",
+      "discriminator": [
+        227,
+        109,
+        144,
+        20,
+        65,
+        239,
+        101,
+        176
+      ]
+    },
+    {
+      "name": "TokenCreatedEvent",
+      "discriminator": [
+        96,
+        122,
+        113,
+        138,
+        50,
+        227,
+        149,
+        57
+      ]
+    },
+    {
+      "name": "TokensClaimedEvent",
+      "discriminator": [
+        93,
+        215,
+        57,
+        103,
+        166,
+        229,
+        107,
+        50
+      ]
+    }
+  ],
+  "errors": [
+    {
+      "code": 6000,
+      "name": "InvalidLaunchState",
+      "msg": "Invalid launch state for this operation"
+    },
+    {
+      "code": 6001,
+      "name": "NotFundraiseActive",
+      "msg": "Launch is not in FundraiseActive state"
+    },
+    {
+      "code": 6002,
+      "name": "NotReadyToLaunch",
+      "msg": "Launch is not in ReadyToLaunch state"
+    },
+    {
+      "code": 6003,
+      "name": "NotTokenCreated",
+      "msg": "Launch is not in TokenCreated state"
+    },
+    {
+      "code": 6004,
+      "name": "NotLaunched",
+      "msg": "Launch is not in Launched state"
+    },
+    {
+      "code": 6005,
+      "name": "AlreadyCancelled",
+      "msg": "Launch has already been cancelled"
+    },
+    {
+      "code": 6006,
+      "name": "CannotCancelLaunched",
+      "msg": "Cannot cancel a launched sale"
+    },
+    {
+      "code": 6007,
+      "name": "Unauthorized",
+      "msg": "Unauthorized: signer is not the platform admin"
+    },
+    {
+      "code": 6008,
+      "name": "InvalidCreator",
+      "msg": "Invalid creator: signer does not match launch creator"
+    },
+    {
+      "code": 6009,
+      "name": "InvalidAmount",
+      "msg": "Invalid amount: must be greater than zero"
+    },
+    {
+      "code": 6010,
+      "name": "ParticipantTokensExceedSupply",
+      "msg": "tokens_to_participants must be less than total_supply"
+    },
+    {
+      "code": 6011,
+      "name": "TokenDistributionOverflow",
+      "msg": "Computed token amounts overflow total supply"
+    },
+    {
+      "code": 6012,
+      "name": "InvalidVanityDerivation",
+      "msg": "Invalid vanity derivation: derived address does not match expected mint"
+    },
+    {
+      "code": 6013,
+      "name": "BaseKeypairMismatch",
+      "msg": "Base keypair does not match configured vanity base pubkey"
+    },
+    {
+      "code": 6014,
+      "name": "MintAlreadyExists",
+      "msg": "Mint account already exists"
+    },
+    {
+      "code": 6015,
+      "name": "VanityConfigNotSet",
+      "msg": "Vanity config not set on launch config"
+    },
+    {
+      "code": 6016,
+      "name": "BaseMintNotSet",
+      "msg": "Base mint not set on launch config"
+    },
+    {
+      "code": 6017,
+      "name": "VaultNotTgeRequested",
+      "msg": "Vault status is not TgeRequested"
+    },
+    {
+      "code": 6018,
+      "name": "FundraiseStateMismatch",
+      "msg": "Fundraise state does not match launch config"
+    },
+    {
+      "code": 6019,
+      "name": "AllocationsNotCalculated",
+      "msg": "Vault allocations not yet calculated"
+    },
+    {
+      "code": 6020,
+      "name": "DepositorVaultMismatch",
+      "msg": "Depositor record does not belong to this vault"
+    },
+    {
+      "code": 6021,
+      "name": "DepositorUserMismatch",
+      "msg": "Depositor record does not match the claiming user"
+    },
+    {
+      "code": 6022,
+      "name": "InvalidVaultProgram",
+      "msg": "Invalid vault program for deserialization"
+    },
+    {
+      "code": 6023,
+      "name": "ClaimsNotYetActive",
+      "msg": "Claims are not yet active: pool activation time has not arrived"
+    },
+    {
+      "code": 6024,
+      "name": "ActivationTimeTooSoon",
+      "msg": "Pool activation time is too soon"
+    },
+    {
+      "code": 6025,
+      "name": "ActivationTimeTooFar",
+      "msg": "Pool activation time is too far in the future"
+    },
+    {
+      "code": 6026,
+      "name": "DustSweepGracePeriodNotElapsed",
+      "msg": "Dust sweep grace period has not elapsed"
+    },
+    {
+      "code": 6027,
+      "name": "NothingToClaim",
+      "msg": "No tokens available to claim"
+    },
+    {
+      "code": 6028,
+      "name": "NoAllocation",
+      "msg": "User has no allocation in the fundraise"
+    },
+    {
+      "code": 6029,
+      "name": "MathOverflow",
+      "msg": "Arithmetic overflow"
+    },
+    {
+      "code": 6030,
+      "name": "DivisionByZero",
+      "msg": "Division by zero"
+    },
+    {
+      "code": 6031,
+      "name": "TokenVaultEmpty",
+      "msg": "Token vault has no balance to sweep"
+    },
+    {
+      "code": 6032,
+      "name": "PoolActivationTimeNotSet",
+      "msg": "Pool activation time not set"
+    }
+  ],
+  "types": [
+    {
+      "name": "ClaimRecord",
+      "docs": [
+        "Per-user claim record (PDA: [\"claim\", launch_config, user]).",
+        "Tracks vesting progress and claimed amounts."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch",
+            "docs": [
+              "The launch this claim belongs to"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "user",
+            "docs": [
+              "The user who owns this claim"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "user_record",
+            "docs": [
+              "Link to vault's DepositorRecord (for tier lookup)"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "total_tokens",
+            "docs": [
+              "User's full token entitlement (cached on first claim)"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "total_claimed",
+            "docs": [
+              "Running total of tokens the user has claimed"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "last_claim_at",
+            "docs": [
+              "Timestamp of the last claim"
+            ],
+            "type": "i64"
+          },
+          {
+            "name": "bump",
+            "docs": [
+              "PDA bump"
+            ],
+            "type": "u8"
+          }
+        ]
+      }
+    },
+    {
+      "name": "ConfigureLaunchArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "base_pubkey",
+            "docs": [
+              "Public key of the base keypair for vanity mint derivation"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "vanity_seed",
+            "docs": [
+              "Seed string for createAccountWithSeed (up to 32 bytes)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "expected_mint",
+            "docs": [
+              "The expected derived mint address"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "name",
+            "docs": [
+              "Token name (max 32 chars)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "symbol",
+            "docs": [
+              "Token symbol (max 10 chars)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "uri",
+            "docs": [
+              "Token metadata URI (max 200 chars)"
+            ],
+            "type": "string"
+          }
+        ]
+      }
+    },
+    {
+      "name": "DepositorRecord",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "depositor",
+            "type": "pubkey"
+          },
+          {
+            "name": "vault",
+            "type": "pubkey"
+          },
+          {
+            "name": "tier",
+            "docs": [
+              "Vesting tier (0-6): 0=immediate, 1=2wk, 2=4wk, 3=6wk, 4=8wk, 5=10wk, 6=12wk",
+              "Set on first deposit, can only be upgraded (not downgraded)"
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "amount",
+            "type": "u64"
+          },
+          {
+            "name": "final_amount",
+            "type": "u64"
+          },
+          {
+            "name": "refunded",
+            "type": "bool"
+          },
+          {
+            "name": "excess_refunded",
+            "type": "bool"
+          },
+          {
+            "name": "bump",
+            "type": "u8"
+          }
+        ]
+      }
+    },
+    {
+      "name": "DustSweptEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "admin",
+            "type": "pubkey"
+          },
+          {
+            "name": "amount",
+            "type": "u64"
+          },
+          {
+            "name": "destination",
+            "type": "pubkey"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "ExecuteLaunchArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "pool_activation_time",
+            "docs": [
+              "When pool trading + token claims become active"
+            ],
+            "type": "i64"
+          },
+          {
+            "name": "dao_name",
+            "docs": [
+              "DAO name for futarchy (max 32 chars)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "treasury_cosigner",
+            "docs": [
+              "Cosigner pubkey for the DAO treasury multisig"
+            ],
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
+    {
+      "name": "FundraiseParams",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "min_raise",
+            "type": "u64"
+          },
+          {
+            "name": "target_raise",
+            "type": "u64"
+          },
+          {
+            "name": "start_time",
+            "type": "i64"
+          },
+          {
+            "name": "end_time",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "InitializeLaunchArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "seed",
+            "docs": [
+              "Unique seed for the launch PDA"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "vault_seed",
+            "docs": [
+              "Seed for the vault PDA (passed to vault::make)"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "total_supply",
+            "docs": [
+              "Total token supply to mint"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_participants",
+            "docs": [
+              "Tokens allocated to fundraise participants"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "fundraise_params",
+            "docs": [
+              "Fundraise configuration (passed to vault::make)"
+            ],
+            "type": {
+              "defined": {
+                "name": "FundraiseParams"
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchCancelledEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "admin",
+            "type": "pubkey"
+          },
+          {
+            "name": "previous_state",
+            "type": "u8"
+          },
+          {
+            "name": "tokens_burned",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchConfig",
+      "docs": [
+        "Main launch configuration account (PDA: [\"launch\", creator, seed]).",
+        "Tracks the entire lifecycle of a token launch from fundraise through claims."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "seed",
+            "docs": [
+              "Unique seed for this launch PDA"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "bump",
+            "docs": [
+              "PDA bump for the launch config"
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "launchpad_signer_bump",
+            "docs": [
+              "PDA bump for the launchpad_signer (derived from launch_config)"
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "creator",
+            "docs": [
+              "The creator who initiated the launch"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "launchpad_signer",
+            "docs": [
+              "The launchpad_signer PDA — controls token_vault, funds_vault, mint authority"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "fundraise_program",
+            "docs": [
+              "The fundraise program ID (vault program for now)"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "fundraise_state",
+            "docs": [
+              "The specific fundraise account (vault PDA)"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "vault_seed",
+            "docs": [
+              "Seed used for vault PDA derivation (for CPI verification)"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "base_mint",
+            "docs": [
+              "Derived vanity mint address (set in configure_launch)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "quote_mint",
+            "docs": [
+              "Quote mint: SOL (wSOL) or USDC"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "vanity_config",
+            "docs": [
+              "Vanity mint derivation params (set in configure_launch)"
+            ],
+            "type": {
+              "option": {
+                "defined": {
+                  "name": "VanityConfig"
+                }
+              }
+            }
+          },
+          {
+            "name": "token_name",
+            "docs": [
+              "Token name (padded, from Arweave metadata)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "token_symbol",
+            "docs": [
+              "Token symbol (padded, from Arweave metadata)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "token_uri",
+            "docs": [
+              "Token metadata URI (Arweave link)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "total_supply",
+            "docs": [
+              "Total token supply to mint"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_participants",
+            "docs": [
+              "Tokens allocated to fundraise participants (for claims)"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_liquidity",
+            "docs": [
+              "Tokens to pool liquidity: tokens_to_participants * 20%"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_team",
+            "docs": [
+              "Tokens to team: total_supply - participants - liquidity.",
+              "Sent to PLATFORM_ADMIN ATA, NOT to team/creator directly."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "treasury_share_bps",
+            "docs": [
+              "Fund share to DAO treasury (constant: 8000 = 80%)"
+            ],
+            "type": "u16"
+          },
+          {
+            "name": "liquidity_share_bps",
+            "docs": [
+              "Fund share to pool liquidity (constant: 2000 = 20%)"
+            ],
+            "type": "u16"
+          },
+          {
+            "name": "state",
+            "docs": [
+              "Current launch state"
+            ],
+            "type": {
+              "defined": {
+                "name": "LaunchState"
+              }
+            }
+          },
+          {
+            "name": "pool_activation_time",
+            "docs": [
+              "When trading + claims unlock (set in execute_launch)"
+            ],
+            "type": {
+              "option": "i64"
+            }
+          },
+          {
+            "name": "executed_at",
+            "docs": [
+              "When execute_launch was called"
+            ],
+            "type": {
+              "option": "i64"
+            }
+          },
+          {
+            "name": "pool",
+            "docs": [
+              "DAMM pool address"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "position_nft_mint",
+            "docs": [
+              "Position NFT mint (LP position)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "dao",
+            "docs": [
+              "DAO account (futarchy)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "squads_multisig",
+            "docs": [
+              "Squads multisig for treasury"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "dao_treasury",
+            "docs": [
+              "DAO treasury (Squads vault PDA of treasury_multisig — holds 80% funds)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "dao_mint_authority",
+            "docs": [
+              "DAO mint authority (Squads vault PDA of mint_multisig — controls token minting)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "new_dao_admin",
+            "docs": [
+              "ZC managed admin wallet — DAMM pool creator (owns LP position NFT) + futarchy DAO admin"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "token_vault",
+            "docs": [
+              "Token vault: ATA of launchpad_signer for base_mint (holds tokens_to_participants)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "funds_vault",
+            "docs": [
+              "Funds vault: ATA of launchpad_signer for quote_mint (intermediate, empty after execute)"
+            ],
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "total_claimed",
+            "docs": [
+              "Running total of tokens claimed across all users"
+            ],
+            "type": "u64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchConfigUpdatedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "admin",
+            "type": "pubkey"
+          },
+          {
+            "name": "new_base_mint",
+            "type": "pubkey"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchConfiguredEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "admin",
+            "type": "pubkey"
+          },
+          {
+            "name": "base_mint",
+            "type": "pubkey"
+          },
+          {
+            "name": "token_name",
+            "type": "string"
+          },
+          {
+            "name": "token_symbol",
+            "type": "string"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchExecutedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "admin",
+            "type": "pubkey"
+          },
+          {
+            "name": "pool",
+            "type": "pubkey"
+          },
+          {
+            "name": "dao",
+            "type": "pubkey"
+          },
+          {
+            "name": "dao_treasury",
+            "type": "pubkey"
+          },
+          {
+            "name": "new_dao_admin",
+            "docs": [
+              "ZC managed admin wallet — DAMM pool creator (LP NFT owner) + futarchy DAO admin"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "total_allocated",
+            "type": "u64"
+          },
+          {
+            "name": "funds_to_pool",
+            "type": "u64"
+          },
+          {
+            "name": "funds_to_treasury",
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_participants",
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_liquidity",
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_team",
+            "type": "u64"
+          },
+          {
+            "name": "pool_activation_time",
+            "type": "i64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchInitializedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "creator",
+            "type": "pubkey"
+          },
+          {
+            "name": "fundraise_state",
+            "type": "pubkey"
+          },
+          {
+            "name": "quote_mint",
+            "type": "pubkey"
+          },
+          {
+            "name": "total_supply",
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_participants",
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_liquidity",
+            "type": "u64"
+          },
+          {
+            "name": "tokens_to_team",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "LaunchState",
+      "type": {
+        "kind": "enum",
+        "variants": [
+          {
+            "name": "FundraiseActive"
+          },
+          {
+            "name": "ReadyToLaunch"
+          },
+          {
+            "name": "TokenCreated"
+          },
+          {
+            "name": "Launched"
+          },
+          {
+            "name": "Cancelled"
+          }
+        ]
+      }
+    },
+    {
+      "name": "StarVault",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "seed",
+            "type": "u64"
+          },
+          {
+            "name": "authority",
+            "type": "pubkey"
+          },
+          {
+            "name": "quote_mint",
+            "type": "pubkey"
+          },
+          {
+            "name": "quote_token_program",
+            "type": "pubkey"
+          },
+          {
+            "name": "minimum_raise_target",
+            "type": "u64"
+          },
+          {
+            "name": "target_raise_amount",
+            "type": "u64"
+          },
+          {
+            "name": "total_deposited",
+            "type": "u64"
+          },
+          {
+            "name": "total_deposited_before_excess",
+            "type": "u64"
+          },
+          {
+            "name": "vault_balance_at_tge",
+            "docs": [
+              "Snapshot of vault_ata.amount at TGE acceptance, BEFORE funds are routed.",
+              "Used by claim_dust to compute max claimable dust after TGE (when vault_ata",
+              "balance is reduced). If 0, TGE has not occurred yet.",
+              "FIX: M01 - Prevents DoS on dust claims after tge_accept."
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "start_time",
+            "type": "i64"
+          },
+          {
+            "name": "end_time",
+            "type": "i64"
+          },
+          {
+            "name": "status",
+            "type": {
+              "defined": {
+                "name": "VaultStatus"
+              }
+            }
+          },
+          {
+            "name": "total_depositors",
+            "type": "u32"
+          },
+          {
+            "name": "is_oversubscribed",
+            "docs": [
+              "Set to true on tge_accept when total_deposited > target_raise_amount.",
+              "Enables claim_excess_refund for pro-rata refunds."
+            ],
+            "type": "bool"
+          },
+          {
+            "name": "bump",
+            "type": "u8"
+          },
+          {
+            "name": "tier_totals",
+            "docs": [
+              "Total deposits per tier: [tier0..tier6]",
+              "tier0 = immediate (0 weeks), tier1 = 2 weeks, tier2 = 4 weeks,",
+              "tier3 = 6 weeks, tier4 = 8 weeks, tier5 = 10 weeks, tier6 = 12 weeks"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "tier_depositor_counts",
+            "docs": [
+              "Number of unique depositors per tier"
+            ],
+            "type": {
+              "array": [
+                "u32",
+                7
+              ]
+            }
+          },
+          {
+            "name": "tier_allocated",
+            "docs": [
+              "Allocated amount per tier after calculate_allocations (0 until calculated)",
+              "Higher tiers get priority in allocation"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "total_allocated",
+            "docs": [
+              "Total amount allocated across all tiers (sum of tier_allocated)",
+              "Used by Launchpad to compute user's share of the token distribution"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "tier_totals_at_allocation",
+            "docs": [
+              "Snapshot of tier_totals at allocation time (for consistent pro-rata refund calculation)",
+              "Using live tier_totals would cause inconsistent refunds as users claim sequentially"
+            ],
+            "type": {
+              "array": [
+                "u64",
+                7
+              ]
+            }
+          },
+          {
+            "name": "allocations_calculated",
+            "docs": [
+              "True once calculate_allocations has been called (prevents re-calculation)"
+            ],
+            "type": "bool"
+          }
+        ]
+      }
+    },
+    {
+      "name": "TokenCreatedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "base_mint",
+            "type": "pubkey"
+          },
+          {
+            "name": "total_supply",
+            "type": "u64"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "TokensClaimedEvent",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "launch_config",
+            "type": "pubkey"
+          },
+          {
+            "name": "user",
+            "type": "pubkey"
+          },
+          {
+            "name": "amount_claimed",
+            "type": "u64"
+          },
+          {
+            "name": "total_claimed_by_user",
+            "type": "u64"
+          },
+          {
+            "name": "total_vested",
+            "type": "u64"
+          },
+          {
+            "name": "tier",
+            "type": "u8"
+          },
+          {
+            "name": "timestamp",
+            "type": "i64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "UpdateLaunchConfigArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "base_pubkey",
+            "docs": [
+              "New base pubkey for vanity mint derivation"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "vanity_seed",
+            "docs": [
+              "New seed string for createAccountWithSeed (up to 32 bytes)"
+            ],
+            "type": "string"
+          },
+          {
+            "name": "expected_mint",
+            "docs": [
+              "New expected derived mint address"
+            ],
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
+    {
+      "name": "VanityConfig",
+      "docs": [
+        "Vanity mint derivation parameters.",
+        "The base keypair's secret is held off-chain by admin until create_launch_token.",
+        "After create_launch_token, it can be discarded."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "base_pubkey",
+            "docs": [
+              "Public key of the base keypair used to derive the vanity mint"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "vanity_seed",
+            "docs": [
+              "Seed string for createAccountWithSeed (padded to 32 bytes)"
+            ],
+            "type": {
+              "array": [
+                "u8",
+                32
+              ]
+            }
+          },
+          {
+            "name": "vanity_seed_len",
+            "docs": [
+              "Actual length of the seed string"
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "expected_mint",
+            "docs": [
+              "The derived mint address: SHA256(base_pubkey || seed || TOKEN_PROGRAM_ID)"
+            ],
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
+    {
+      "name": "VaultStatus",
+      "type": {
+        "kind": "enum",
+        "variants": [
+          {
+            "name": "Active"
+          },
+          {
+            "name": "AwaitingTgeRequest"
+          },
+          {
+            "name": "TgeRequested"
+          },
+          {
+            "name": "TgeAccepted"
+          },
+          {
+            "name": "Cancelled"
+          }
+        ]
+      }
+    }
+  ],
+  "constants": [
+    {
+      "name": "LAUNCH_SEED",
+      "type": "bytes",
+      "value": "[108, 97, 117, 110, 99, 104]"
+    }
+  ]
+}