Sign in
auth v1

Link external wallet.

Changed on
post/iam/v1/siwe/link

Request

  • Base URL: https://api.openfort.io
  • URL: https://api.openfort.io/iam/v1/siwe/link
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Request body

signaturestring required

Signature of the EIP-712 message with the user's wallet.

messagestring required

The EIP-712 message to sign.

walletClientTypestring required

The wallet client of the user

connectorTypestring required

The connector type of the user

Example request

{
  "signature": "0x1773ca2e6514a795bc9549ffbdf73909b2cd0ba8eafe52a1751c3ee8d644458701debd502ee5b5a8fca24606eee42a2cc756a04958c7c189913184d46c48783e1b",
  "message": "demo.openfort.io wants you to sign in with your Ethereum account:",
  "walletClientType": "metamask",
  "connectorType": "injected"
}

Response

Ok

idstring required
object'player' required
createdAtinteger required

Example response

{
  "player": {
    "transactionIntents": [
      {
        "chainId": 5,
        "details": {
          "from": "0x8ab66318aCC6b29A27e74e534bfe3ecf81C50387",
          "data": "0x8c5a...",
          "nonce": "0",
          "gas": "21000",
          "maxFeePerGas": "1000000000",
          "maxPriorityFeePerGas": "1000000000",
          "value": "0x8ab66318aCC6b29A27e74e534bfe3ecf81C50387"
        },
        "response": {
          "error": {
            "reason": "AA31: paymaster deposit too low",
            "name": "ExecutionResult",
            "explanation": {
              "cause": "The paymaster does not have enough native tokens deposited in the EntryPoint to cover the gas cost.",
              "solution": "Top up your account balance in the dashboard or deposit more to the Paymaster contract on the relevant chain."
            }
          }
        },
        "finalCost": "0.42",
        "interactions": [
          {
            "value": "1000000000000000000",
            "contract": "con_0cddb398-1dc6-4e6f-8726-9ec7cea85f35",
            "functionName": "mint",
            "functionArgs": [
              "0x662D24Bf7Ea2dD6a7D0935F680a6056b94fE934d"
            ]
          }
        ]
      }
    ]
  }
}

Changes

  • 5019a5edea73Revision changes
    • info

      removed from the /////////// response property anyOf list for the response status

    • info

      removed the zkSync enum value from the /////////// response property for the response status

  • 88be7ccfca19Revision changes
    • breaking

      the //////////// response's property type changed from no type to object for status

    • info

      added the optional property /////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status

    • info

      added the optional property ///////////// to the response with the status

    • info

      added the required property ///////////// to the response with the status