contract.created

​

v1.0.1

add userId field

contract.created webhook (v1.0.1)

Added the userId field to the webhook payload. This field contains the Rain user ID associated with the contract’s userAddress, when a matching user exists.

New Field

Field	Type	Description
body.userId	string (optional)	The Rain user ID associated with the userAddress. May be undefined if no matching user is found.

Example Payload (v1.0.1)

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "contract",
    "action": "created",
    "version": "1.0.1",
    "body": {
        "id": "cc_abc123",
        "userAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "chainId": "1",
        "proxyAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
        "depositAddress": "0xfedcba0987654321fedcba0987654321fedcba09",
        "controllerAddress": "0x9876543210fedcba9876543210fedcba98765432",
        "contractVersion": 1,
        "userId": "usr_def456"
    }
}

​

v1.0.0

initial release

contract.created webhook

Added the contract.created webhook. Rain sends this webhook when a new collateral smart contract is deployed for a user. It provides the contract details including addresses needed for depositing collateral.

Payload Fields

Field	Type	Description
id	string	Webhook ID
resource	string	Always "contract"
action	string	Always "created"
version	string	The webhook version
body.id	string	The collateral contract ID
body.userAddress	string	The user’s wallet address associated with the contract
body.chainId	string	The blockchain chain ID (e.g., "1" for Ethereum mainnet)
body.proxyAddress	string (optional)	The proxy contract address
body.depositAddress	string (optional)	The address that receives collateral deposits
body.controllerAddress	string (optional)	The coordinator/controller contract address
body.contractVersion	number	The version of the smart contract

Example Payload

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "contract",
    "action": "created",
    "version": "1.0.0",
    "body": {
        "id": "cc_abc123",
        "userAddress": "0x1234567890abcdef1234567890abcdef12345678",
        "chainId": "1",
        "proxyAddress": "0xabcdef1234567890abcdef1234567890abcdef12",
        "depositAddress": "0xfedcba0987654321fedcba0987654321fedcba09",
        "controllerAddress": "0x9876543210fedcba9876543210fedcba98765432",
        "contractVersion": 1
    }
}