Sign in
safe-shield

Analyze transaction counterparties on a Space

Changed on

Performs combined contract and recipient analysis for a Safe transaction on a Safe registered to a Space, gated by the copilot_scans plan entitlement.

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

Request

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

Path parameters

chainIdstring required

Chain ID where the Safe is deployed

safeAddressstring required

Safe contract address, must be registered to the Space

spaceIdstring required

Space UUID

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