Self-hosting

Run your own Facilitator on stellar:testnet from a clean machine. It needs Node.js 24+, the pinned pnpm (run corepack enable), and Docker for a local PostgreSQL database and a Redis-protocol channel store.

Testnet bring-up

git clone https://github.com/57blocks/agentsmith-oss
cd agentsmith-oss
corepack enable
pnpm install --frozen-lockfile
cp packages/facilitator/.env.example packages/facilitator/.env
pnpm --filter @agentsmith/stellar-facilitator testnet:create-account
# Put the three printed FACILITATOR_STELLAR_* lines into packages/facilitator/.env
docker compose -f packages/facilitator/docker-compose.yml up -d postgres valkey
pnpm build
pnpm start

The service applies database migrations, then listens at http://127.0.0.1:8407. The default configuration enables testnet exact and experimental upto against the pre-deployed testnet Kernel, so no contract deployment is required.

For mainnet, run a separate instance and configuration: require a Resource Server API key and serve stellar:pubnet. The Facilitator exposes no public key-issuance route — you issue, rotate and revoke keys through its internal credentials gRPC service (on the hosted service the AgentSmith platform does this). That service and the discovery-usage listener bind to their own ports and must be reachable only on your private network, never the public internet. See the Facilitator README for the full configuration reference.