# Get Started

## Requirements

If you want to create an x2earn app it needs to have the following features:

* Be able to **distribute B3TR** tokens on the VeChain blockchain
* Be able to **submit a proof** (in JSON format) of the sustainable action the user was rewarded for

Bonus:

* Allow the user to **connect** with their [wallet](https://vechain-kit.vechain.org/) to your app

This guide provides instructions for setting up a project within the VeBetter ecosystem. Your app will participate in weekly allocation rounds, receive B3TR tokens at the beginning of each round, and distribute these

<figure><img src="https://1270501492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5gLJKT3UdlvblZqAiaZ2%2Fuploads%2FKWIEoJeWUOPxcuoMOata%2FUntitled.png?alt=media&#x26;token=158f2756-a3a6-40eb-98f2-301a412e8c0c" alt=""><figcaption><p>Architecture overview of components that could be involved in creating a x2earn app</p></figcaption></figure>

## Test Environment

Use our [Test Environment](https://staging.testnet.governance.vebetterdao.org/) to create a test app running **in the VeBetter ecosystem.**

{% content-ref url="test-environment" %}
[test-environment](https://docs.vebetterdao.org/developer-guides/test-environment)
{% endcontent-ref %}

## **Distribute B3TR**

Get some B3TR tokens on testnet, add a reward distributor then connect a smart contract or a backend and distribute rewards to your users.

{% content-ref url="testnet-b3tr-tokens" %}
[testnet-b3tr-tokens](https://docs.vebetterdao.org/developer-guides/testnet-b3tr-tokens)
{% endcontent-ref %}

{% content-ref url="reward-distribution" %}
[reward-distribution](https://docs.vebetterdao.org/developer-guides/reward-distribution)
{% endcontent-ref %}

## Proofs and Impacts

Every time you reward a user you also need to specify the reason, the proof of the user's action and the sustainability impact it had.

{% content-ref url="sustainability-proof-and-impacts" %}
[sustainability-proof-and-impacts](https://docs.vebetterdao.org/developer-guides/sustainability-proof-and-impacts)
{% endcontent-ref %}

## Resources

Have doubts? Check our additional resources specifically picked for you to speed up your development.

{% content-ref url="resources" %}
[resources](https://docs.vebetterdao.org/developer-guides/resources)
{% endcontent-ref %}

## Submit App

When your app is ready submit it to VeBetter and join the movement!

{% content-ref url="submit-your-app" %}
[submit-your-app](https://docs.vebetterdao.org/developer-guides/submit-your-app)
{% endcontent-ref %}

## RuleBook

{% content-ref url="rulebook-for-apps" %}
[rulebook-for-apps](https://docs.vebetterdao.org/developer-guides/rulebook-for-apps)
{% endcontent-ref %}

## Security

{% hint style="danger" %}
Before going live be sure to go through our [Security Considerations](https://docs.vebetterdao.org/developer-guides/security-considerations) along the [RuleBook](https://docs.vebetterdao.org/developer-guides/rulebook-for-apps). Make sure to apply security measures to your app, avoiding hacks and farmers.
{% endhint %}

{% content-ref url="security-considerations" %}
[security-considerations](https://docs.vebetterdao.org/developer-guides/security-considerations)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vebetterdao.org/developer-guides/get-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.