cheater_apis.md

API Documentation

1. Associated Wallets API

Endpoint:
POST /

Description:
Checks one or more assets by denom or address to determine their properties and relationships.

Request Body:

• Single Address:

  { "address": "0x809FF4801aA5bDb33045d1fEC810D082490D63a4" }

• Multiple Addresses:

  { "addresses": ["sei1example", "0xExampleEVM", "ibc/ExamplePointer"] }

Response Format:

• For Single Address:

  {
    "address": "0x809FF4801aA5bDb33045d1fEC810D082490D63a4",
    "isBaseAsset": true,
    "isPointer": false,
    "pointerAddress": "",
    "pointeeAddress": ""
  }

• For Multiple Addresses:

  [
    {
      "address": "sei1example",
      "isBaseAsset": true,
      "isPointer": false,
      "pointerAddress": "",
      "pointeeAddress": ""
    },
    {
      "address": "0xExampleEVM",
      "isBaseAsset": false,
      "isPointer": true,
      "pointerAddress": "",
      "pointeeAddress": "sei1example"
    }
  ]

---

2. Address Conversion API

Endpoint:
POST /query-address

Description:
Converts Sei or EVM addresses to their linked counterpart.

Request Body:

{ "addresses": ["sei1example", "0xExampleEVM"] }

Response:

[
  "0xLinkedEVMAddress",
  "sei1LinkedSeiAddress"
]

• If unassociated, returns null for that address.

---

Health Check

Endpoint:
GET /

Description:
Verifies the server is running.

Example:

curl http://localhost:3000

---

URLs

• Determine Address Properties:
  https://pointer.basementnodes.ca/

• Address Conversion:
  https://wallet-api.sei.basementnodes.ca/query-address

---

Example Usage:

• Single Address Request (Determine Properties):

  curl -X POST https://pointer.basementnodes.ca/ \
  -H "Content-Type: application/json" \
  -d '{"address": "0x809FF4801aA5bDb33045d1fEC810D082490D63a4"}'

• Multiple Address Request (Conversion):

  curl -X POST https://wallet-api.sei.basementnodes.ca/query-address \
  -H "Content-Type: application/json" \
  -d '{"addresses": ["sei1example", "0xExampleEVM"]}'