1.8 KiB
Palworld REST reference adapter
This package contains DoGaMa's reference WebAssembly translator for the private Palworld REST API. Container lifecycle and archive handling remain in generic DoGaMa workflows.
Endpoint mapping
| Normalized operation | Palworld REST endpoint |
|---|---|
test_connection, get_server_info, get_server_status |
GET /v1/api/info |
get_metrics |
GET /v1/api/metrics |
list_players |
GET /v1/api/players |
save_world |
POST /v1/api/save |
shutdown |
POST /v1/api/shutdown |
send_announcement |
POST /v1/api/announce |
kick_player |
POST /v1/api/kick |
ban_player |
POST /v1/api/ban |
unban_player |
POST /v1/api/unban |
The mappings follow the official Palworld REST API.
Isolation
The host binds the logical instance_api destination to the instance container and its private rest_api port. The adapter receives no destination URL and can import only restricted WASI plus dogama_host functions. The runtime provides no filesystem, environment, process, raw socket, DNS or host clock capability.
Credentials come only from the declared username configuration and admin_password secret. Responses, requests, host-call count, memory, execution time and concurrency are bounded by the runtime.
Reproducible build
From the repository root, using Go 1.25 or newer:
CGO_ENABLED=0 GOOS=wasip1 GOARCH=wasm go build \
-trimpath -buildmode=c-shared \
-o modules/palworld-rest/module.wasm ./modules/palworld-rest/src
sha256sum modules/palworld-rest/module.wasm
The checksum must exactly match manifest.yaml. Repository tests instantiate the real artifact under wazero and exercise it against a bounded fake Palworld transport.