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.