Debug Graft invocations

1. Enable byte-level Gateway logging

export GG_DEBUG=1
gg <module>

Warning: logs may contain sensitive payload bytes. Use only in controlled environments.

2. Verify the hosted surface

  1. Confirm the intended runtime in Gateway output.
  2. Open Vision on the configured HTTP port (default 81).
  3. Compare discovered types/methods with your source.
  4. Re-copy the install command from this Gateway instance.

3. Verify Caller configuration

  • Remote: host/Host set to ws:// or wss:// before the first call.
  • In-memory: Receiver module locally resolvable.
  • After config changes, restart the Caller process (context is cached).

4. Classify the failure

SymptomLikely cause
FileNotFound Receiver DLLinmemory without local module
422 package generationunsupported public type
Connection timeoutwrong host, proxy, or TLS termination
Missing methodfilters, stale package, or discovery gap

See Troubleshooting index.

Receiver example

dotnet build ./Pricing/Pricing.csproj
gg ./Pricing/bin/Debug/net9.0/Pricing.dll
## Next steps