Migration Guide: Updating Your DataDAO for Rewards

This guide is for owners of existing DataDAOs who need to update their projects to meet the latest Vana protocol standards. Completing these steps is required to become eligible for the DataDAO Rewards program.

📘

Before You Begin

This is a technical guide that assumes you have administrative ownership of your DataDAO's token contract and access to its application codebase.

Step 1: Achieve VRC-20 Token Compliance

This section outlines how to make an existing token compliant with the VRC-20 Token Standard.

1. Mint Remaining Supply: Use the mint() function on your token contract to mint the full intended supply. This must be called from the owner address.
2. Freeze Minting: Call the blockMint() function on the token contract to permanently disable any future minting.
3. Lock Team Tokens: Move all team-allocated tokens into a vesting contract. The contract must enforce a minimum 6-month cliff followed by a linear unlock period. We recommend using OpenZeppelin’s VestingWallet contract.
4. Define Token Utility: Update your public documentation to specify how your token functions within the data ecosystem, including how it is earned, how it governs data access, and how it integrates with the Vana Data Access Architecture.
5. Verify Contracts: Ensure your token contract and any related contracts (e.g., vesting) are verified on the block explorer.
6. Submit for Review: Once vesting is in place and minting is locked, send your token address to the Vana team in Discord for final approval.

📘

Custom Token?

If your token was not deployed using the original DAT template, contact the Vana team for custom migration support.

Step 2: Implement VRC-15 Data Refinement

To comply with the VRC-15 Data Access Architecture, you must update your data pipeline.

1. Initialize Your Refiner: Follow the Data Refinement & Publishing to fork and set up the necessary repository.
2. Customize Your Logic: In the forked repository, update the following files to match your DataDAO's specific schemas and data sources:
   • refiner/models/unrefined.py to reflect your raw dataset.
   • refiner/models/refined.py to define your new, structured schema.
   • refiner/transformer/ to update the data mapping logic.
   • refiner/config.py with your schema name, version, and other metadata.
3. Integrate the/refine Endpoint: Your application should call the /refine endpoint after data has been verified by your Proof-of-Contribution process. Send a POST request with the following structure:
   JSON

   {
     "file_id": 1234,
     "encryption_key": "0xabcd1234...",
     "refiner_id": 12,
     "env_vars": {
       "PINATA_API_KEY": "xxx",
       "PINATA_API_SECRET": "yyy"
     }
   }

   Use the appropriate endpoint for your environment:
   • Mainnet: https://592387e3ed196d95ce8df7af54dab6ebca21a3c8-8000.dstack-prod5.phala.network/refine
   • Moksha Testnet: https://a7df0ae43df690b889c1201546d7058ceb04d21b-8000.dstack-prod5.phala.network/refine

Step 3: Establish VRC-14 Liquidity

To comply with VRC-14, your DataDAO token must have sufficient liquidity paired against $VANA on DataDex.

1. Create the Pool: Navigate to Pools → New Position on datadex.com.

• Select your DataDAO token and $VANA as the pair. If your token is not yet listed, you can paste its contract address to proceed.
• Use the Full Range liquidity option and choose a Starting Price for your token. This will affect your token's initial Fully Diluted Valuation (FDV).
• Deposit both tokens to create the pool.

Provide Sufficient Liquidity: Your pool must be deep enough to handle daily reward-related buys with less than 2% slippage.

1. • Example Calculation: For Epoch 6, 150,000 $VANA will be distributed over 91 days. If your DataDAO receives 10% of that pool, it will see ~82 $VANA used to buy your token daily. Your pool must be able to absorb this buy pressure.
   • Recommendation: A starting pool of ~$5–10K in total liquidity may be sufficient, but you must monitor slippage and add liquidity if it approaches 2% on daily swaps.

Final Steps

Once you complete these steps and meet the requirements outline in DataDAO Rewards, your DataDAO will be compliant after a final review from the Vana team.

Need help? Reach out in the #tech-questions channel in the Vana Builders Discord.