haedal-vehaedal（海达尔韦海达尔）

Haedal VeHaedal

Haedal Protocol is a DeFi ecosystem on the SUI blockchain. VeHaedal is its vote-escrowed governance token: lock HAEDAL for veHaedal to earn rewards and voting power; lock duration and optional decay affect reward rates. This skill calls the Haedal Skills API for add stake, extend lock, claim rewards, decay control, and unstake — no custom scripts required.

Call the VeHaedal HTTP APIs directly with curl.

All numeric parameters are human‑readable amounts: pass amount and similar quantity fields as human‑readable values, without multiplying by decimals. For example, to stake 20 tokens, simply send "amount":"20".

Querying veHaedal objects (get_vehaedal_list)

Several methods (add_to_existing_stake, extend_existing_lock, start_decay, stop_decay, unstake_and_claim) require a vehaedalObj — the object ID of an existing veHaedal position. When the user triggers one of these methods:

1. Ask the user whether they already have the veHaedal object ID. If yes, use it directly.
2. If discovery is needed: call get_vehaedal_list with the user's address. On HTTP 200 the response body is: {"list": [{"objectId": "0x...", "fields": {"current_amount": "10000000000", "initial_amount": "10000000000", "is_decaying": true, "lock_end_time": "1803708378450", "lock_start_time": "1772258778450", "locked_amount": "10000000000", "original_lock_weeks": "52", "owner": "0x...", "remaining_lock_weeks_when_stopped_decay": "52", "token_type": {"fields": {"name": "...::haedal::HAEDAL"}, "type": "0x1::type_name::TypeName"}}}]}
3. Present the list to the user in a readable format — show key fields such as objectId, current_amount, locked_amount, is_decaying, original_lock_weeks, lock_end_time for each entry.
4. Let the user choose which veHaedal object to operate on (or take the first entry if only one exists). Use the selected objectId as the vehaedalObj parameter for the subsequent call.

Flow summary: user triggers a method that requires vehaedalObj → ask if they have the object ID → if not, call get_vehaedal_list(address) → present the list → user selects one → take that objectId as vehaedalObj → call the target method.

Base URL

https://skillsapi.haedal.xyz/api/v1/vehaedal

Request body

curl examples

add_stake

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/add_stake" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","amount":"20","lockWeeks":4,"isDecaying":false}'

get_vehaedal_list (query veHaedal objects owned by an address, used to obtain vehaedalObj)

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/get_vehaedal_list" \
  -H "Content-Type: application/json" \
  -d '{"address":"0xYOUR_ADDRESS"}'

add_to_existing_stake (requires vehaedalObj, obtainable from get_vehaedal_list → list[].objectId)

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/add_to_existing_stake" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","vehaedalObj":"0xOBJECT_ID","amount":"10"}'

extend_existing_lock (requires vehaedalObj)

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/extend_existing_lock" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","vehaedalObj":"0xOBJECT_ID","additionalWeeks":2}'

start_decay (requires vehaedalObj)

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/start_decay" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","vehaedalObj":"0xOBJECT_ID"}'

stop_decay (requires vehaedalObj)

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/stop_decay" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","vehaedalObj":"0xOBJECT_ID"}'

unstake_and_claim (requires vehaedalObj)

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/unstake_and_claim" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","vehaedalObj":"0xOBJECT_ID"}'

claim_rewards_v2

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/claim_rewards_v2" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS","periods":["1","2"]}'

claim_rewards_v2_epoch_1

curl -s -w "\n%{http_code}" -X POST "https://skillsapi.haedal.xyz/api/v1/vehaedal/claim_rewards_v2_epoch_1" \
  -H "Content-Type: application/json" \
  -d '{"signerAddress":"0xYOUR_ADDRESS"}'

Response

• add_stake / add_to_existing_stake / extend_existing_lock / start_decay / stop_decay / unstake_and_claim / claim_rewards_v2 / claim_rewards_v2_epoch_1: on HTTP 200, the body is {"txBytes":"<base64>"}; use jq -r '.txBytes' to extract it. On non‑200, use jq -r '.msg' to extract the error reason and return it to the user.
• get_vehaedal_list: on HTTP 200, the body is {"list":[{"objectId":"...","fields":{...}},...]}. Use jq -r '.list' to obtain the list, then take the desired entry's objectId as the vehaedalObj for subsequent calls.

MoveAbort error codes

When a dry-run or build call fails with MoveAbort(..., <code>), use the following mapping: