APISIX plugin - dynamo-gateway-apisix
Not in the preview yet. This feature is built in the repository but is off in the v2.2.6 preview (test mode). Do not treat this page as available on a preview core. See ../preview.md and the release notes.
An Apache APISIX 3.x plugin (Lua, Apache-2.0) implementing the SAME canonical plugin contract as Kong and litellm-dynamo: the same decision table, the same 402 challenge schema, the same conformance vectors. Allowance credentials verify offline against pinned engine signers (no network call in the request path), units meter from the response payload and tick to the engine asynchronously, and missing/stale/revoked-at-last-sync state denies - fail closed.
The plugin is not published; mount it from a clone.
Everything decision-shaped lives in apisix/plugins/dynamo/core/*, the byte-identical vendor copy of the Kong core (make audit-plugin-core enforces it); the APISIX host shim handles schema, phases, headers, and timers only. Its refusals are therefore Kong's, including the two only a multi-worker gateway gives (a busy shared lock, a full shared dict): both are headroom unknown refusals with Retry-After: 1 and nothing reserved (see known limits).
Config surface
Field-for-field identical to the Kong plugin's table - expressed as an APISIX JSON schema, attachable per route or as global plugin config: engine_url and engine_signers required; max_stale_seconds, sync_seconds, the four units_per_* metering rates, reserved_units_per_response (required on a route with a token price above 0; the route is refused without it), the x402 seller fields (pay_to, asset, resources), exposure and finality bounds, and journal_dir for the durable meter journal.
Deployment shape
Standalone (no etcd): mount the package's apisix/ tree, set
apisix:
extra_lua_path: "/opt/dynamo/?.lua"
plugins:
- dynamo
and attach the plugin to routes in apisix.yaml. Route-level config works the same through the Admin API / etcd in a full deployment. Pinned image: apache/apisix:3.11.0-debian (pinned by digest). Newer APISIX releases are not tested.
Verify
Docker is required.
cd "$DYNAMO_REPO"
pwd
make test-gateways # the core spec inside the PINNED apisix image
make test-gateways-journal # core + meter journal, APISIX 3.11 beside three Kong images
make audit-plugin-core # core byte-identical across gateways
make conformance-apisix # full x402 catalog vs a LIVE APISIX container
make p17 # 10k-vector decision parity vs {reference, litellm, kong}
If a gateway's architecture ever forced divergent behavior, that would be a blocker to resolve openly - never a silent adaptation.