Jump to

• Request
• Response

Propose an Upgrade Intent

post

/v1/governance/intents/upgrade

Proposes a governance intent to upgrade the specified proxy to a new implementation, identified by its code hash and governed by a deadline under the policy `uuid`.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• async: boolean
  Default Value: false
• deadline(required): integer (int64)
  Future Unix epoch time in seconds.
• fromAddress(required): string
  Pattern: ^0x[a-fA-F0-9]{40}$
• implementationCodeHash(required): string
  Pattern: ^0x[a-fA-F0-9]{64}$
• newImplementation(required): string
  Pattern: ^0x[a-fA-F0-9]{40}$
• proxy(required): string
  Pattern: ^0x[a-fA-F0-9]{40}$
• uuid(required): string (uuid)

{
    "type":"object",
    "required":[
        "uuid",
        "proxy",
        "newImplementation",
        "implementationCodeHash",
        "deadline",
        "fromAddress"
    ],
    "properties":{
        "uuid":{
            "type":"string",
            "format":"uuid"
        },
        "proxy":{
            "type":"string",
            "pattern":"^0x[a-fA-F0-9]{40}$"
        },
        "newImplementation":{
            "type":"string",
            "pattern":"^0x[a-fA-F0-9]{40}$"
        },
        "implementationCodeHash":{
            "type":"string",
            "pattern":"^0x[a-fA-F0-9]{64}$"
        },
        "deadline":{
            "type":"integer",
            "format":"int64",
            "description":"Future Unix epoch time in seconds."
        },
        "fromAddress":{
            "type":"string",
            "pattern":"^0x[a-fA-F0-9]{40}$"
        },
        "async":{
            "type":"boolean",
            "default":false
        }
    }
}

Security

• bearerAuth: http
  Type: http

Back to Top

Response

200 Response

Transaction receipt confirmed

202 Response

Transaction submitted or receipt not yet available

400 Response

Bad request.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

404 Response

Requested resource was not found.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

500 Response

Internal server error.

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
  Example: bad_request
• details: array details
• message(required): string
  Example: The request could not be processed.

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string",
            "example":"bad_request"
        },
        "message":{
            "type":"string",
            "example":"The request could not be processed."
        },
        "details":{
            "type":"array",
            "items":{
                "type":"string"
            }
        }
    },
    "required":[
        "message"
    ]
}

Nested Schema : details

Type: array

Show Source

• Array of: string

{
    "type":"array",
    "items":{
        "type":"string"
    }
}

Back to Top