Nodes

Check wallet address on whitelist

This endpoint allows backend systems to check the whitelist status of addresses. It provides a simple and efficient way to verify if an address is whitelisted.

It requires a wallet address to be provided as input and returns a boolean value: true if whitelisted, false if not.

Tier title and whitelist key are optional query (url) parameters that allow to narrow the search of whitelists for the project.

curl -G -X GET <https://app.magna.so/api/external/v1/nodes/whitelists/address-status> \\\\
-H 'Content-Type: application/json' \\\\
-H 'x-magna-api-token: magna_project_api_token' \\\\
-d "walletAddress=0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"

• magna_project_api_token (required) - replace with your actual Magna API token

• walletAddress (required) - the address of the wallet you’re checking against the project’s whilitests

• tierTitle (optional) - the title of the tier to narrow search of project’s whitelists

• whitelistKey (optional) - the key of the whitelist to check wallet address on

Response example:

{
  "isProcessed": true,
  "result": true
}

Use Cases:

• Allocations Claiming:

  • List Allocations: Developers can utilize the get allocations endpoint to fetch a comprehensive list of all allocations stored in the Magna platform. This allows for easy access to allocation data for analysis or processing purposes.

  • Retrieve Specific Allocation: Users can use the get allocation by id endpoint to retrieve detailed information about a specific allocation by providing its unique identifier. This functionality is useful for targeted actions such as processing token claims or verifying allocation status.

  • Claim Allocation Tokens: Users can use the claim allocations endpoint to get parameters for signing the transaction for claiming the allocation tokens.

• Signing Start & Fund Transactions:

  • Create start and fund transactions for allocations: currently done through Magna UI.

  • Retrieve Existing transaction parameters: Users can use the existing endpoint to retrieve transaction parameters for all existing admin transactions excluding the claims. This functionality is useful for targeted actions such as starting and funding allocations on-chain.

  • Index Transaction: Users can trigger the indexing of existing transactions by using the existing endpoint. To do this, they need to provide the transaction ID and the transaction hash. This feature is particularly useful for specific actions, such as indexing a transaction after signing its parameters and obtaining its hash.

• Token Summary:

  • Retrieve Token Summary: Users can use the existing endpoint to retrieve the token summary with comprehensive token details and statistics allocations stored in the Magna platform. This allows for easy access to token information such as total claimed tokens for analysis or processing purposes.

Security Considerations:

• Ensure proper authentication mechanisms are in place to restrict access to the endpoint only to authorized users or projects.

• Implement secure communication protocols such as HTTPS to protect data integrity during API interactions.

• Apply appropriate access controls and permissions to prevent unauthorized access or modification of allocation data.