# Project Backend

## I. Permissions and Login

### 1.1Account Permissions

1. Permissions: All users can log in via Endless or Luffa Wallet.

### 1.2Log in to the Odyssey project

2. Project backend:<https://odyssey.endless.link/union/login>

<figure><img src="/files/p5pmT7rsgA2ZIKWQ78Sq" alt=""><figcaption></figcaption></figure>

3. Wallet Login: Select an account and proceed with the login and authorization process.

<figure><img src="/files/Nx6e4dmK3Zf2UDhAQefH" alt=""><figcaption></figcaption></figure>

## II. Project Review

### 2.1.Basic Information

1. Information to be filled in: Company Name, Official Website, Email Address, Luffa ID

<figure><img src="/files/897f4yumndBdgPPaUWUp" alt=""><figcaption></figcaption></figure>

### 2.2Project Information

1. Information to fill in: Project Name, Project Logo, Project Description
2. Project Name: Enter a project name that does not yet exist.
3. Project Logo: Enter the URL of the complete project logo.
4. Project Description: The project description should not exceed 500 characters.

<figure><img src="/files/tOFJwUxfF9birHs64tBV" alt=""><figcaption></figcaption></figure>

### 2.3social media

1. Information: Twitter, Telegram, Luffa Channel, Discord
2. Social Media Links: Please enter the complete URL
3. Submission for Review: After clicking Submit, the task will be reviewed by the official administrator. Once approved, the task can be created.

<figure><img src="/files/goiZZPfU87LM1lF78OAH" alt=""><figcaption></figcaption></figure>

### 2.4Review status

1. Unreviewed: Currently, the only action that can be taken is submitting the project for review.

<figure><img src="/files/V5qUtayQOm1PxHOhkEft" alt=""><figcaption></figcaption></figure>

2. Under Review: The project can be resubmitted for review in the current status. If the review has been approved and tasks exist, completed and unstarted tasks can be deleted, but new tasks cannot be added.

<figure><img src="/files/DUrz29oEGSCTJtypNnmq" alt=""><figcaption></figcaption></figure>

3. Approved: In this status, you can resubmit the project for review and manage tasks. Note that resubmitting will change the status to "under review".

<figure><img src="/files/FoVJAJdMP5FmqIUiQB5P" alt=""><figcaption></figcaption></figure>

## III. Adding a Task

### 3.1Adding an Entry Point

1. Add entry point: Click the "Add" button on the task list page to be redirected to the task addition page.

<figure><img src="/files/2HdSkdCUvjwkLOhKbElo" alt=""><figcaption></figcaption></figure>

### 3.2Task Information

1. Information to fill in: Project Name, Task Name, Task Description, Task Cover, Start Time, End Time
2. Project Name: Defaults to the approved project name and cannot be modified.
3. Task Name: Custom task name, cannot be duplicated, and cannot exceed 50 characters.
4. Task Description: Cannot exceed 200 characters. You can fill in the relevant rules and procedures for this task.
5. Task Cover: Click to upload the task cover. Please upload according to the recommended size (Recommended size: 330px \* 230px).
6. Start Time: Defaults to the current time. Click to select a time.
7. End Time: Defaults to 7 days from the current time. Click to select a time. The end time must be more than 24 hours after the start time.

<figure><img src="/files/3fxb75fSIvTo0ZslKHe7" alt=""><figcaption></figcaption></figure>

### 3.3Task restrictions

1. Prerequisite Tasks: The dropdown menu displays a list of ongoing tasks with a "Single" cycle. Clicking on a prerequisite task allows the user to complete it before starting the current task. If no prerequisite task is specified, there is no prerequisite.
2. Points Limit: Users can select project/platform points. After entering the points, the user's project/platform points must be greater than or equal to the entered value to complete the current task. If the value is empty or 0, there is no limit.
3. Usage Scenarios: 51 points allow upgrading to Level 2, which enables on-chain tasks. In this case, the "At Least Points" field should be set to platform points and 51 points should be entere,upgrading to Level 2 in the admin panel's level settings requires configuring 51 points.

<figure><img src="/files/3XQ776JSb2OuNwGspmsC" alt=""><figcaption></figcaption></figure>

### 3.4Task settings

1. Task Types: The default display shows the "Follow Twitter" task type. Click on other task types on the right to switch between them. The information required for each type is detailed in the task type explanation.

<figure><img src="/files/kCb7G5ttIwUC1c7cLLvk" alt=""><figcaption></figcaption></figure>

### 3.5Reward settings

1. Fill in the information: Task period, task reward, total reward
2. Task period: Single is a one-time task, Daily is a daily task, and Weekly is a weekly task; the current off-chain task type (social media task) can only be Single.
3. Task reward: The points reward you can get after completing the task; note that in API tasks, this field is only for display, and the actual points issued are determined by the third-party API.
4. Total reward: The task will automatically end when the total reward is depleted and becomes 0; checking "No Limit" will not limit the total reward amount.

<figure><img src="/files/EyEHK5DjkZUpm5Za9cay" alt=""><figcaption></figcaption></figure>

### 3.6Activity Rewards

1. Activation Requirements: Only tasks with a "Daily" task cycle can activate activity rewards.
2. Information to Enter: Number of Active Days, Activity Rewards; a maximum of 5 activity rewards can be added.
3. Number of Active Days: Enter the number of consecutive days the user needs to complete the task. Activity rewards will be awarded after reaching the set number of active days.
4. Activity Rewards: Enter the user's activity reward. The set activity reward will be awarded after meeting the required number of active days.
5. Note: If the user interrupts their activity, the activity progress will reset to zero. Activity rewards can still be earned repeatedly after reaching the required number of active days.

<figure><img src="/files/FMiTdKSIvSIqrDaVoyS6" alt=""><figcaption></figcaption></figure>

### 3.7Task review

1. Click the Submit button to submit all task information. Once the task is approved, it can be displayed on the Odyssey front-end.

![](/files/eO98Gx9DQmv263y81rsN)<br>

## IV. Task Type

### 4.1Follow on Twitter

1. Twitter Account Name: Enter the name of the Twitter account the user needs to follow.

![](/files/MTZFJvT86PMHVJI1IZHH)<br>

### 4.2Retweet a tweet

1. Twitter Post Link: Enter the link to the Twitter post that you want users to share.

![](/files/bG2i9wqjhflTqhXpm3Iu)<br>

### 4.3Reply tweet with hashtags

1. Fill in the information: Twitter link, hashtags
2. Twitter post link: Enter the link to the Twitter post that requires user comments
3. Hashtags: Up to 10 hashtags can be set. User comments must include the hashtags to receive rewards.

![](/files/mfHQw3Eo9pmjeFPsqD5s)<br>

### 4.4Join the Luffa group

1. Fill in the information: Luffa group link
2. Luffa group link: Enter the complete Luffa group link that the user needs to join.

<figure><img src="/files/w1qEYjdsIvGf0whVXuXM" alt=""><figcaption></figcaption></figure>

### 4.5Follow the Luffa channel

1. Fill in the information: Luffa channel link
2. Luffa channel link: Enter the complete Luffa channel link that the user needs to follow.

![](/files/fpvnA3cK6GJxjZhd0KIA)<br>

### 4.6Coin transfer

1. Information to fill in: coin address, minimum transfer requirement, number of completions, task link
2. Coin address: Enter the complete address from which the user needs to transfer coins.
3. Minimum transfer requirement: How many coins need to be transferred per transaction to count as a completion.
4. Number of completions: How many completions are required to earn points rewards.
5. Task link: Enter the task link address that the user will be redirected to when completing the task.

![](/files/40diwDkWVnVIuap1Ab4u)<br>

### 4.7Complete smart contract tasks

1. Information to fill in: Contract function, number of completions, task link
2. Contract function: Enter the contract function that the user needs to execute. If there are multiple functions, separate them with commas. Completing any one of the functions counts as one completion.
3. How Many Times: How many completions are required to earn points.
4. Task link: Enter the task link address that the user is redirected to when completing the task.

![](/files/aojWP6gnjOxCs2gABgyo)<br>

### 4.8Tasks Completed Based On APl

1. Fill in the information: API URL, maximum reward per task, maximum reward per address, task link
2. API URL: Enter the complete URL that conforms to the API specifications. The API specifications will be explained in detail below.
3. Reward Cap: The maximum reward after each task completion cannot exceed the set value, and cannot exceed the maximum reward per address; you can also set no maximum.
4. Reward limits per address: When the user's reward reaches the maximum, the task will be marked as completed; you can also set no maximum.
5. Task link: Enter the task link address that the user will be redirected to when performing the task.

![](/files/G1yZIxHz2u24gM29XSZ9)<br>

## V. API Specification

### 5.1Overview

1. How third-party platforms can query a user's completed tasks and earned points within a specified time period via API. Third-party platforms need to implement the API interface according to this specification so that our system can obtain the user's task completion records.

### 5.2Interface Instance

```json
{
    "code": 0,
    "data": {
        "list": [
            {
                "id": "3250458370007",
                "timestamp": 1764566807248,
                "points": 16,
                "desc": "Sold EDS worth 16 USDT"
            }
        ]
    },
    "msg": "success"
}
```

### 5.3Interface Specification

1. URL parameters

| Start time (milliseconds) | start\_time |
| ------------------------- | ----------- |
| End time (milliseconds)   | end\_time   |
| Account address           | account     |

2. Response HTTP status

| Normal   | 200     |
| -------- | ------- |
| Abnormal | Non-200 |

3. Response Content

| Unique identifier for claiming points | id        |
| ------------------------------------- | --------- |
| Task completion time (milliseconds)   | timestamp |
| Points received                       | points    |
| describe                              | desc      |

## VI. Points History

### 6.1View project user points

1. On the points list page, you can view the user's points history for completing tasks, and activity reward points will also be directly displayed in the corresponding tasks.

<figure><img src="/files/tIH94X7d9IBRT9XExsyT" alt=""><figcaption></figcaption></figure>


---

# 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.endless.link/endless/endless-odyssey/project-backend.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.
