HTTP API reference › GalaSwap DEX › shadow
GalaSwap DEX — shadow
3 operations in this group.
- GET /v1/shadow/history/{wallet}/challenge — Request a wallet-ownership challenge
- POST /v1/shadow/history/{wallet}/session — Exchange a signed challenge for a session token
- GET /v1/shadow/history/{wallet} — Owner's shadow swap history
GET /v1/shadow/history/{wallet}/challenge
ShadowController_getChallenge
Request a wallet-ownership challenge
Returns a single-use nonce + message to personal_sign, to bootstrap an owner session for shadow history.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| wallet | path | required | string |
Responses
200 —
Content type: application/json
Schema: ShadowChallengeResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | string enum: success | yes | |
| data | ShadowChallengeDataResponseDto | yes |
400 —
Content type: application/json
Schema: ShadowHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | oneOf: string | array<string> | yes | |
| error | string | no |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
POST /v1/shadow/history/{wallet}/session
ShadowController_createSession
Exchange a signed challenge for a session token
Verifies the EIP-191 signature against the issued challenge and returns a wallet-bound bearer token.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| wallet | path | required | string |
Request body
Required: yes
application/json
Schema: ShadowSessionRequestDto
| Field | Type | Required | Description |
|---|---|---|---|
| signature | string | yes | personal_sign signature of the challenge message returned by /challenge |
Responses
200 —
Content type: application/json
Schema: ShadowSessionResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | string enum: success | yes | |
| data | ShadowSessionTokenResponseDto | yes |
400 —
Content type: application/json
Schema: ShadowHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | oneOf: string | array<string> | yes | |
| error | string | no |
401 —
Content type: application/json
Schema: ShadowHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | oneOf: string | array<string> | yes | |
| error | string | no |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example request
[]
Example response
[]
GET /v1/shadow/history/{wallet}
ShadowController_getHistory
Owner's shadow swap history
Owner-scoped list of the wallet's shadow swaps (isShadow: true), paged via page (0-based) + size. Requires a wallet-bound Bearer session token (from /challenge + /session); the non-prod ?__seed path returns synthetic rows without auth for FE development.
Authentication: shadow-bearer
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| wallet | path | required | string | |
| page | query | optional | number | 0-based page index |
| size | query | optional | number | Page size |
| __seed | query | optional | number | Non-prod only: return N synthetic sample rows so the FE can exercise the render/merge path. |
| authorization | header | required | string |
Responses
200 —
Content type: application/json
Schema: ShadowHistoryResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| status | string enum: success | yes | |
| data | ShadowHistoryDataResponseDto | yes |
400 —
Content type: application/json
Schema: ShadowHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | oneOf: string | array<string> | yes | |
| error | string | no |
401 —
Content type: application/json
Schema: ShadowHttpErrorResponseDto
| Field | Type | Required | Description |
|---|---|---|---|
| statusCode | number | yes | |
| message | oneOf: string | array<string> | yes | |
| error | string | no |
default — An error response using the shared backend error envelope.
Content type: application/json
Schema: ApiErrorEnvelope
| Field | Type | Required | Description |
|---|---|---|---|
| status | integer | yes | |
| error | boolean | yes | |
| message | string | yes | |
| errorKey | string | no |
Example response
[]
Previous group: token-registry