safe-shield

Analyze transaction counterparties

Changed on

Performs combined contract and recipient analysis for a Safe transaction. Returns both analyses grouped by status group for each counterparty.

post/v1/chains/{chainId}/security/{safeAddress}/counterparty-analysis

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

chainIdstring required
Example:1

Chain ID where the Safe is deployed

safeAddressstring required

Safe contract address

Request body

tostring required

Recipient address of the transaction.

valuestring required

Amount to send with the transaction.

datastring required

Hex-encoded data payload for the transaction.

operation0 | 1 required

Operation type: 0 for CALL, 1 for DELEGATECALL.

Response

Combined counterparty analysis including recipients and contracts grouped by status group and mapped to an address.

recipientobject required

Recipient analysis results mapped by address. Contains recipient interaction history and bridge analysis.type: Record<Address, RecipientAnalysisDto>.

contractobject required

Contract analysis results mapped by address. Contains contract verification, interaction history, and delegatecall analysis.type: Record<Address, ContractAnalysisDto>.

deadlockobject required

Deadlock analysis results mapped by Safe address. Contains signing deadlock risk findings for owner/threshold management transactions.

Example response

{
  "recipient": {
    "0x0000000000000000000000000000000000000000": {
      "isSafe": true,
      "RECIPIENT_INTERACTION": [
        {
          "severity": "INFO",
          "type": "NEW_RECIPIENT",
          "title": "New recipient",
          "description": "This is the first time you are interacting with this recipient"
        }
      ]
    }
  },
  "contract": {
    "0x0000000000000000000000000000000000000000": {
      "CONTRACT_VERIFICATION": [
        {
          "severity": "INFO",
          "type": "VERIFIED",
          "title": "Verified contract",
          "description": "This contract has been verified and its source code is available"
        }
      ]
    }
  },
  "deadlock": {
    "0x0000000000000000000000000000000000000000": {
      "DEADLOCK": [
        {
          "severity": "CRITICAL",
          "type": "DEADLOCK_DETECTED",
          "title": "Signing deadlock risk detected",
          "description": "This change may create a signing cycle between Safes and can permanently lock funds. You will not be allowed to proceed forward."
        }
      ]
    }
  }
}

Changes

    • info

      added the required 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 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 optional property //// to the response with the status

    • info

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