Document ENS resolution support for profiles API (#76)

Author: yosriady

api/openapi.json

@@ -4166,7 +4166,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Filter by wallet address"
+            "description": "Filter by wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address."
           },
           {
             "name": "expand",
@@ -4314,7 +4314,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Wallet address"
+            "description": "Wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address."
           },
           {
             "name": "expand",
@@ -4524,7 +4524,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Wallet address (EVM 0x... or Solana base58)"
+            "description": "Wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address."
           },
           { "$ref": "#/components/parameters/IdempotencyKey" }
         ],
@@ -4656,7 +4656,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Wallet address (EVM 0x... or Solana base58)"
+            "description": "Wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address."
           },
           { "$ref": "#/components/parameters/IdempotencyKey" }
         ],
@@ -4745,7 +4745,7 @@
             "schema": {
               "type": "string"
             },
-            "description": "Wallet address (EVM 0x... or Solana base58)"
+            "description": "Wallet address. Accepts an EVM (0x...) or Solana address, or an ENS name (e.g. vitalik.eth) which is resolved to an address."
           },
           { "$ref": "#/components/parameters/IdempotencyKey" }
         ],

api/profiles/get.mdx

@@ -28,7 +28,7 @@ The API key needs to have the **read permission for profiles** in the API settin
 
 ## Path parameters
 
-- `address` (string): EVM Wallet address e.g. `0x0000000000000000000000000000000000000000`.
+- `address` (string): A wallet address or ENS name. Accepts an EVM address (e.g. `0x0000000000000000000000000000000000000000`), a Solana address, or an ENS name (e.g. `vitalik.eth`). ENS names are resolved to an address before lookup.
 
 ## Query parameters
 
@@ -294,7 +294,7 @@ Array of token holdings:
 
 | Status | Code | Description |
 |--------|------|-------------|
-| 400 | `BAD_REQUEST` | Invalid wallet address format |
+| 400 | `BAD_REQUEST` | Invalid address or ENS name, or the ENS name could not be resolved |
 | 401 | `UNAUTHORIZED` | Missing or invalid API key |
 | 403 | `FORBIDDEN` | API key does not have `profiles:read` permission |
 | 404 | `PROFILE_NOT_FOUND` | Profile does not exist |

api/profiles/search.mdx

@@ -22,12 +22,17 @@ The API key needs to have the **read permission for profiles** in the API settin
 
 ### `address`
 
-Filter by a specific wallet address (exact match).
+Filter by a specific wallet address (exact match). Accepts an EVM address, a Solana address, or an ENS name (e.g. `vitalik.eth`) which is resolved to an address before filtering. An unresolvable ENS name or an otherwise invalid value returns a `400 BAD_REQUEST`.
 
 ```bash
 curl -sS -X GET \
   -H "Authorization: Bearer <your_workspace_api_key>" \
   "https://api.formo.so/v0/profiles?address=0x1234..."
+
+# ENS names are resolved automatically
+curl -sS -X GET \
+  -H "Authorization: Bearer <your_workspace_api_key>" \
+  "https://api.formo.so/v0/profiles?address=vitalik.eth"
 ```
 
 ### `search`