lfx-reward-back-sdk 0.1.0

package/dist/idl/lfx_reward_sc.json

@@ -0,0 +1,998 @@
+{
+  "address": "rwDAq5g55oUWSve43iiijTwebCe6NrPAJQ3ftpJ1tC1",
+  "metadata": {
+    "name": "lfx_reward_sc",
+    "version": "0.1.0",
+    "spec": "0.1.0",
+    "description": "LFX Reward Smart Contract",
+    "repository": "https://github.com/LIFENetworks/lfx_reward_sc"
+  },
+  "instructions": [
+    {
+      "name": "claim_reward",
+      "docs": [
+        "User",
+        "Claim reward tokens (user + API signer)."
+      ],
+      "discriminator": [
+        149,
+        95,
+        181,
+        242,
+        94,
+        90,
+        158,
+        162
+      ],
+      "accounts": [
+        {
+          "name": "user",
+          "docs": [
+            "User who receives the reward"
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "api",
+          "docs": [
+            "API wallet that authorizes the reward amount off-chain"
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "user_token_account",
+          "docs": [
+            "User's associated token account for the reward mint"
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_token_account",
+          "docs": [
+            "Vault token account PDA (Token-2022)"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint",
+          "docs": [
+            "Reward token mint (Token-2022)"
+          ],
+          "writable": true
+        },
+        {
+          "name": "global_info",
+          "docs": [
+            "Global config PDA"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "token_program",
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "ClaimRewardArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "deposit_tokens",
+      "docs": [
+        "Deposit reward tokens into the vault."
+      ],
+      "discriminator": [
+        176,
+        83,
+        229,
+        18,
+        191,
+        143,
+        176,
+        150
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "admin_token_account",
+          "writable": true
+        },
+        {
+          "name": "vault_token_account",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint",
+          "writable": true
+        },
+        {
+          "name": "global_info",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "token_program",
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "DepositTokensArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "init_global_info",
+      "docs": [
+        "Admin",
+        "Initialize global reward configuration and vault."
+      ],
+      "discriminator": [
+        181,
+        239,
+        139,
+        80,
+        66,
+        140,
+        67,
+        140
+      ],
+      "accounts": [
+        {
+          "name": "init_wallet",
+          "docs": [
+            "Init wallet signer (must match hardcoded INIT_WALLET_ADDRESS)"
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "global_info",
+          "docs": [
+            "Global config PDA"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "vault_token_account",
+          "docs": [
+            "Vault token account PDA (Token-2022)"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint",
+          "docs": [
+            "Reward token mint (Token-2022)"
+          ]
+        },
+        {
+          "name": "token_program",
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "InitGlobalInfoArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "start_withdrawal_vote",
+      "docs": [
+        "Start a withdrawal wallet change vote."
+      ],
+      "discriminator": [
+        151,
+        141,
+        194,
+        115,
+        123,
+        127,
+        181,
+        186
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "global_info",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "withdrawal_vote",
+          "docs": [
+            "Global withdrawal vote PDA (single instance for the program)"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  119,
+                  105,
+                  116,
+                  104,
+                  100,
+                  114,
+                  97,
+                  119,
+                  97,
+                  108,
+                  95,
+                  118,
+                  111,
+                  116,
+                  101
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "StartWithdrawalVoteArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "update_global_info",
+      "docs": [
+        "Update global configuration (admin/api/internal multisig/emergency)."
+      ],
+      "discriminator": [
+        84,
+        172,
+        119,
+        223,
+        36,
+        64,
+        248,
+        180
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "global_info",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "UpdateGlobalInfoArgs"
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "vote_withdrawal_wallet",
+      "docs": [
+        "Cast a vote for the current withdrawal wallet change proposal."
+      ],
+      "discriminator": [
+        135,
+        181,
+        210,
+        66,
+        195,
+        178,
+        72,
+        7
+      ],
+      "accounts": [
+        {
+          "name": "voter",
+          "docs": [
+            "One of the internal multisig wallets (must match one of the entries in global_info.internal_multisig_wallets)"
+          ],
+          "signer": true
+        },
+        {
+          "name": "global_info",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "withdrawal_vote",
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  119,
+                  105,
+                  116,
+                  104,
+                  100,
+                  114,
+                  97,
+                  119,
+                  97,
+                  108,
+                  95,
+                  118,
+                  111,
+                  116,
+                  101
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      "args": []
+    },
+    {
+      "name": "withdraw_tokens",
+      "docs": [
+        "Withdraw tokens from the vault to the configured withdrawal wallet."
+      ],
+      "discriminator": [
+        2,
+        4,
+        225,
+        61,
+        19,
+        182,
+        106,
+        170
+      ],
+      "accounts": [
+        {
+          "name": "admin",
+          "docs": [
+            "Admin signer (must match global_info.admin_wallet)"
+          ],
+          "writable": true,
+          "signer": true
+        },
+        {
+          "name": "recipient_token_account",
+          "docs": [
+            "Recipient token account (must belong to current withdrawal_wallet)"
+          ],
+          "writable": true
+        },
+        {
+          "name": "vault_token_account",
+          "docs": [
+            "Vault token account PDA (Token-2022)"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  118,
+                  97,
+                  117,
+                  108,
+                  116
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "mint",
+          "docs": [
+            "Reward token mint (Token-2022)"
+          ],
+          "writable": true
+        },
+        {
+          "name": "global_info",
+          "docs": [
+            "Global config PDA"
+          ],
+          "writable": true,
+          "pda": {
+            "seeds": [
+              {
+                "kind": "const",
+                "value": [
+                  103,
+                  108,
+                  111,
+                  98,
+                  97,
+                  108
+                ]
+              }
+            ]
+          }
+        },
+        {
+          "name": "token_program",
+          "address": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb"
+        },
+        {
+          "name": "system_program",
+          "address": "11111111111111111111111111111111"
+        }
+      ],
+      "args": [
+        {
+          "name": "args",
+          "type": {
+            "defined": {
+              "name": "WithdrawTokensArgs"
+            }
+          }
+        }
+      ]
+    }
+  ],
+  "accounts": [
+    {
+      "name": "GlobalInfo",
+      "discriminator": [
+        241,
+        51,
+        8,
+        81,
+        11,
+        62,
+        44,
+        62
+      ]
+    },
+    {
+      "name": "WithdrawalVote",
+      "discriminator": [
+        93,
+        184,
+        26,
+        60,
+        167,
+        248,
+        29,
+        1
+      ]
+    }
+  ],
+  "errors": [
+    {
+      "code": 6000,
+      "name": "AccessDenied",
+      "msg": "Access denied"
+    },
+    {
+      "code": 6001,
+      "name": "InvalidArgs",
+      "msg": "Invalid arguments"
+    },
+    {
+      "code": 6002,
+      "name": "MathOverflow",
+      "msg": "Math overflow"
+    },
+    {
+      "code": 6003,
+      "name": "EmergencyModeEnabled",
+      "msg": "Emergency mode is enabled"
+    },
+    {
+      "code": 6004,
+      "name": "InvalidAdminWallet",
+      "msg": "Invalid admin wallet"
+    },
+    {
+      "code": 6005,
+      "name": "InvalidApiWallet",
+      "msg": "Invalid API wallet"
+    },
+    {
+      "code": 6006,
+      "name": "InvalidWithdrawalWallet",
+      "msg": "Invalid withdrawal wallet"
+    },
+    {
+      "code": 6007,
+      "name": "InvalidInternalMultisigWallet",
+      "msg": "Invalid internal multisig wallet"
+    },
+    {
+      "code": 6008,
+      "name": "InvalidTokenMint",
+      "msg": "Invalid token mint"
+    },
+    {
+      "code": 6009,
+      "name": "InsufficientVaultBalance",
+      "msg": "Insufficient vault balance"
+    },
+    {
+      "code": 6010,
+      "name": "WithdrawalVoteNotActive",
+      "msg": "Withdrawal vote is not active"
+    },
+    {
+      "code": 6011,
+      "name": "WithdrawalVoteCompleted",
+      "msg": "Withdrawal vote already completed"
+    },
+    {
+      "code": 6012,
+      "name": "NotInternalMultisigWallet",
+      "msg": "Not an internal multisig wallet"
+    }
+  ],
+  "types": [
+    {
+      "name": "ClaimRewardArgs",
+      "docs": [
+        "Claim arguments.",
+        "",
+        "The `amount` must already be validated off-chain by the trusted API backend."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "amount",
+            "docs": [
+              "Raw token amount including decimals (Token-2022 mint decimals)."
+            ],
+            "type": "u64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "DepositTokensArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "amount",
+            "type": "u64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "GlobalInfo",
+      "docs": [
+        "Global reward configuration and state.",
+        "",
+        "This account is the single source of truth for:",
+        "- Admin (multisig) wallet",
+        "- API wallet (trusted offchain backend)",
+        "- Internal multisig participant wallets (5 wallets)",
+        "- Current withdrawal wallet",
+        "- Token-2022 mint used for rewards",
+        "- Aggregate accounting fields"
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "admin_wallet",
+            "docs": [
+              "Solana multisig admin wallet (e.g. SPL multisig program account)"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "api_wallet",
+            "docs": [
+              "API wallet that must co-sign reward claims together with the user"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "internal_multisig_wallets",
+            "docs": [
+              "Five internal multisig wallets for withdrawal wallet voting"
+            ],
+            "type": {
+              "array": [
+                "pubkey",
+                5
+              ]
+            }
+          },
+          {
+            "name": "withdrawal_wallet",
+            "docs": [
+              "Current withdrawal wallet (all withdrawals must go here)"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "token_mint_address",
+            "docs": [
+              "Reward token mint (Token-2022)"
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "total_allocated_token_amount",
+            "docs": [
+              "Total amount of tokens ever allocated into the vault"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "total_claimed_amount",
+            "docs": [
+              "Total amount of tokens ever claimed by users"
+            ],
+            "type": "u64"
+          },
+          {
+            "name": "is_emergency",
+            "docs": [
+              "Emergency flag - when true, claims should be blocked"
+            ],
+            "type": "bool"
+          },
+          {
+            "name": "bump",
+            "docs": [
+              "Bump for global PDA"
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "vault_bump",
+            "docs": [
+              "Bump for vault token account PDA"
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "reserved_data",
+            "docs": [
+              "Reserved for future use, always initialized to 0"
+            ],
+            "type": "u64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "InitGlobalInfoArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "admin_wallet",
+            "type": "pubkey"
+          },
+          {
+            "name": "api_wallet",
+            "type": "pubkey"
+          },
+          {
+            "name": "internal_multisig_wallets",
+            "type": {
+              "array": [
+                "pubkey",
+                5
+              ]
+            }
+          },
+          {
+            "name": "withdrawal_wallet",
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
+    {
+      "name": "StartWithdrawalVoteArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "proposed_withdrawal_wallet",
+            "type": "pubkey"
+          }
+        ]
+      }
+    },
+    {
+      "name": "UpdateGlobalInfoArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "admin_wallet",
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "is_emergency",
+            "type": {
+              "option": "bool"
+            }
+          },
+          {
+            "name": "api_wallet",
+            "type": {
+              "option": "pubkey"
+            }
+          },
+          {
+            "name": "internal_multisig_wallets",
+            "type": {
+              "option": {
+                "array": [
+                  "pubkey",
+                  5
+                ]
+              }
+            }
+          }
+        ]
+      }
+    },
+    {
+      "name": "WithdrawTokensArgs",
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "amount",
+            "type": "u64"
+          }
+        ]
+      }
+    },
+    {
+      "name": "WithdrawalVote",
+      "docs": [
+        "Withdrawal wallet change voting state.",
+        "",
+        "There is a single global voting account (PDA) derived from `SEED_WITHDRAWAL_VOTE`.",
+        "Internal multisig wallets (stored in `GlobalInfo`) can approve a proposed",
+        "new withdrawal wallet. When approvals reach the threshold (3-of-5), the",
+        "program updates `GlobalInfo.withdrawal_wallet` and marks the vote as completed."
+      ],
+      "type": {
+        "kind": "struct",
+        "fields": [
+          {
+            "name": "current_withdrawal_wallet",
+            "docs": [
+              "The current withdrawal wallet at the time the vote was started."
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "proposed_withdrawal_wallet",
+            "docs": [
+              "The proposed new withdrawal wallet."
+            ],
+            "type": "pubkey"
+          },
+          {
+            "name": "approvals",
+            "docs": [
+              "Approvals from internal multisig wallets, matched by index."
+            ],
+            "type": {
+              "array": [
+                "bool",
+                5
+              ]
+            }
+          },
+          {
+            "name": "approvals_count",
+            "docs": [
+              "Number of approvals collected so far."
+            ],
+            "type": "u8"
+          },
+          {
+            "name": "is_active",
+            "docs": [
+              "Whether the vote is currently active."
+            ],
+            "type": "bool"
+          },
+          {
+            "name": "bump",
+            "docs": [
+              "Bump for the WithdrawalVote PDA."
+            ],
+            "type": "u8"
+          }
+        ]
+      }
+    }
+  ]
+}