rust-runner

Standalone Rust repository for Mimic Protocol runner execution logic. Use this directory as the root of a dedicated rust-runner Git repository.

Included workflows

• ci.yml: Rust lint + tests.
• release-node-bindings.yml: publishes @mimicprotocol/runner-node and platform bindings.
• deploy-lambda.yml: manually builds and deploys runner-lambda to AWS Lambda using cargo-lambda and ARM64.

Lambda deployment workflow

Run .github/workflows/deploy-lambda.yml with workflow_dispatch.

Build command used by the workflow:

cargo lambda build --release --arm64 --bin runner-lambda --features lambda

Configure AWS IAM OIDC trust for GitHub Actions and provide the role ARN via GitHub Environment variables (recommended per environment):

• AWS_DEPLOY_ROLE_ARN

Workflow inputs:

• environment (dev or prod)
• alias (default 0-0-1)

GitHub Environments

Create two GitHub Environments and set LAMBDA_FUNCTION_NAME, AWS_REGION, and AWS_DEPLOY_ROLE_ARN in each one:

• dev -> LAMBDA_FUNCTION_NAME=Runnert-stg
• prod -> LAMBDA_FUNCTION_NAME=Runner
• dev/prod -> AWS_REGION=us-east-1 (or the region you use)
• dev/prod -> AWS_DEPLOY_ROLE_ARN=arn:aws:iam::<account-id>:role/<role-name>

The workflow uses environment: ${{ inputs.environment }} and deploys with vars.LAMBDA_FUNCTION_NAME, vars.AWS_REGION, and vars.AWS_DEPLOY_ROLE_ARN.

Local Lambda testing

• Start the local watcher: npm run lambda:watch.
• If you invoke from TypeScript with InvokeCommand, use endpoint http://127.0.0.1:9000, lambda name runner-lambda and credentials accessKeyId=test and secretAccessKey=test.