Skip to content
LogoLogo

API reference

deployoor (main)

Runtime exports for deploy scripts and tooling.

ExportDescription
defineConfigType-safe config helper
defineDeployerLow-level deployer factory (codegen uses this)
defineRegisterRegister external contract factory
defineResetReset deployment records factory
memoryStoreIn-memory StoreAdapter for tests
fsStoreFilesystem store (default in generated deployers)

Generated getOrDeploy<Name> functions are the primary API — import from ./deployers.

deployoor/generate

ExportDescription
generateDeployers({ root })Programmatic deployoor generate

deployoor/plugin

Plugin SDK — the only import path for lifecycle plugins.

ExportDescription
definePluginCreate a named plugin with lifecycle hooks

Hooks include onContractDeployed and others in the deploy pipeline. See Plugins.

DeployResult

type DeployResult<TContract> = {
  contract: TContract;
  freshDeploy: boolean;
  receipt?: TransactionReceipt;
  deployment: DeploymentRecord;
};

DeploymentRecord

Validated at runtime with Zod; exported as a stable TypeScript interface. See Deployment records.

Errors

Tagged errors (e.g. DeploymentExists, ChainIdMismatch, DeploymentFailed) reject from getOrDeploy / register with actionable messages.