> ## Documentation Index
> Fetch the complete documentation index at: https://aomi.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Post v1pipelineevmsimulate

> Stateless chain lifecycle operation. The complete portable Build moves by value; commit revalidates and re-simulates before custody.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/pipeline/evm/simulate
openapi: 3.1.0
info:
  title: Aomi Event and Pipeline API
  version: 1.0.0
  description: >-
    Intent enters the runtime; one ordered stream of concrete Events leaves it.
    Actions are durable Events whose nested ActionRequest requires a client
    response.
servers:
  - url: https://chat.aomi.dev
    description: Production
  - url: https://chat-staging.aomi.dev
    description: Staging
security: []
paths:
  /v1/pipeline/evm/simulate:
    post:
      description: >-
        Stateless chain lifecycle operation. The complete portable Build moves
        by value; commit revalidates and re-simulates before custody.
      operationId: simulateevmPipeline
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PipelineLifecycleRequest'
      responses:
        '200':
          description: Portable chain-specific Build or commit result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PipelineBuild'
        '401':
          $ref: '#/components/responses/Error'
        '403':
          $ref: '#/components/responses/Error'
        default:
          $ref: '#/components/responses/Error'
      security:
        - aomiOAuth:
            - pipeline:execute
components:
  schemas:
    PipelineLifecycleRequest:
      type: object
      description: >-
        Build request, explicit stage input, or a complete portable Build
        envelope depending on the endpoint.
    PipelineBuild:
      type: object
      required:
        - version
        - status
        - actions
        - origin
        - expiresAt
        - digest
        - attestation
      properties:
        version:
          const: 2
        status:
          enum:
            - staged
            - simulated
        actions:
          type: array
        origin:
          type: object
          description: App, skills, and Catalog operations that assembled the actions.
          required:
            - app
            - operations
          properties:
            app:
              type: string
            skills:
              type: array
              items:
                type: string
            operations:
              type: array
        simulation:
          $ref: '#/components/schemas/PipelineSimulation'
        summary: {}
        expiresAt:
          type: integer
          description: Unix timestamp after which commit is rejected.
        digest:
          type: string
          pattern: ^sha256:[0-9a-f]{64}$
        attestation:
          type: string
          description: Server authentication of the Build, its owner, and app scope.
    PipelineSimulation:
      type: object
      required:
        - status
        - balanceChanges
        - approvals
        - fees
        - warnings
        - guards
        - gas
        - logs
      additionalProperties: false
      properties:
        status:
          enum:
            - passed
            - failed
        balanceChanges:
          type: array
          items:
            $ref: '#/components/schemas/PipelineBalanceChange'
        approvals:
          type: array
          items:
            $ref: '#/components/schemas/PipelineApprovalChange'
        fees:
          type: array
          items:
            $ref: '#/components/schemas/PipelineFeeEstimate'
        warnings:
          type: array
          items:
            type: string
        guards:
          type: array
          items:
            $ref: '#/components/schemas/PipelineGuardResult'
        gas:
          oneOf:
            - $ref: '#/components/schemas/PipelineGasEstimate'
            - type: 'null'
        logs:
          type: array
          items:
            $ref: '#/components/schemas/PipelineLog'
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error: {}
    PipelineBalanceChange:
      type: object
      required:
        - asset
        - amount
      additionalProperties: false
      properties:
        account:
          type:
            - string
            - 'null'
        asset:
          type: string
        amount:
          type: string
        direction:
          enum:
            - in
            - out
            - null
        symbol:
          type:
            - string
            - 'null'
        decimals:
          type:
            - integer
            - 'null'
        chainId:
          type:
            - integer
            - 'null'
        cluster:
          type:
            - string
            - 'null'
        standard:
          enum:
            - native
            - erc20
            - erc721
            - erc1155
            - erc721_or_erc1155
            - null
        name:
          type:
            - string
            - 'null'
        tokenId:
          type:
            - string
            - 'null'
        counterparty:
          type:
            - string
            - 'null'
        step:
          type:
            - integer
            - 'null'
          minimum: 1
    PipelineApprovalChange:
      type: object
      required:
        - account
        - spender
        - asset
        - kind
        - standard
      additionalProperties: false
      properties:
        account:
          type: string
        spender:
          type: string
        asset:
          type: string
        kind:
          enum:
            - allowance
            - token
            - operator
        amount:
          type:
            - string
            - 'null'
        approved:
          type:
            - boolean
            - 'null'
        unlimited:
          type:
            - boolean
            - 'null'
        tokenId:
          type:
            - string
            - 'null'
        standard:
          enum:
            - native
            - erc20
            - erc721
            - erc1155
            - erc721_or_erc1155
        symbol:
          type:
            - string
            - 'null'
        name:
          type:
            - string
            - 'null'
        decimals:
          type:
            - integer
            - 'null'
        chainId:
          type:
            - integer
            - 'null'
        step:
          type:
            - integer
            - 'null'
          minimum: 1
    PipelineFeeEstimate:
      type: object
      required:
        - asset
        - amount
      additionalProperties: false
      properties:
        account:
          type:
            - string
            - 'null'
        asset:
          type: string
        amount:
          type: string
        symbol:
          type:
            - string
            - 'null'
        decimals:
          type:
            - integer
            - 'null'
        chainId:
          type:
            - integer
            - 'null'
        cluster:
          type:
            - string
            - 'null'
        kind:
          type:
            - string
            - 'null'
    PipelineGuardResult:
      type: object
      required:
        - name
        - status
      additionalProperties: false
      properties:
        name:
          type: string
        status:
          enum:
            - passed
            - failed
            - warning
        message:
          type:
            - string
            - 'null'
    PipelineGasEstimate:
      type: object
      additionalProperties: false
      properties:
        units:
          type:
            - string
            - 'null'
        priceWei:
          type:
            - string
            - 'null'
        nativeCost:
          type:
            - string
            - 'null'
    PipelineLog:
      type: object
      required:
        - address
        - topics
        - data
      additionalProperties: false
      properties:
        chainId:
          type:
            - integer
            - 'null'
        cluster:
          type:
            - string
            - 'null'
        address:
          type: string
        topics:
          type: array
          items:
            type: string
        data:
          type: string
        step:
          type:
            - integer
            - 'null'
          minimum: 1
  responses:
    Error:
      description: Stable public error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    aomiOAuth:
      type: oauth2
      description: >-
        Better Auth OAuth 2.1 authorization-code/device grants. Access tokens
        are exact-resource bound; the Portal BFF verifies them and delegates a
        downscoped internal bearer.
      flows:
        authorizationCode:
          authorizationUrl: https://chat.aomi.dev/api/auth/oauth2/authorize
          tokenUrl: https://chat.aomi.dev/api/auth/oauth2/token
          scopes:
            agent:read: Read owned Agent turns and sessions
            agent:write: Start, continue, interrupt, update, or delete Agent sessions
            agent:actions:resolve: Resolve a durable Agent Action
            pipeline:catalog: Browse public Pipeline apps, skills, and operations
            pipeline:execute: Attempt Pipeline execution subject to Gate F policy
            account:apps:read: Read available applications and installed state
            account:apps:write: Install and remove applications
            account:credentials:read: Read credential declarations and presence without values
            account:credentials:write: Save and remove owned application credentials
            account:credits:read: Read included allowance and Credit Bank activity
            account:credits:topup: Buy durable Credit Bank value through x402
            account:usage:read: Read priced account usage
            mcp:agent: Use the Agent MCP protected resource
            mcp:pipeline: Use the Pipeline MCP protected resource
            payments:submit: Attach a client-held payment signature
            custody:delegate: Permit separately approved delegated custody
      x-device-authorization-url: https://chat.aomi.dev/api/auth/device/code
      x-aomi-resources:
        agent: https://chat.aomi.dev/v1/agent
        pipeline: https://chat.aomi.dev/v1/pipeline
        agentMcp: https://chat.aomi.dev/v1/agent/mcp
        pipelineMcp: https://chat.aomi.dev/v1/pipeline/mcp
        account: https://chat.aomi.dev/v1/account

````