The StarkNet event mechanism allows a contract to output information during its execution that can later be used outside of StarkNet. For example, consider a token contract that allows transfers of tokens between users. By only querying StarkNet storage, a user can only see how much token they have, and not who transferred those tokens. An event, emitted by the contract whenever funds are transferred, can be used to allow the user to get this information.

Parameters

Object Name	Required	Type	Detail
`fromBlock`	✅	Block Parameter	"block_hash", "block_number", "latest", "pending"
`toBlock`	✅	Block Parameter	"block_hash", "block_number", "latest", "pending"
`address`	✅	String	from contract address
`chunk_size`	✅	Integer	chunk size

{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "starknet_getEvents",
    "params": [
        {
            "from_block": {
                "block_number": 51000
            },
            "to_block": {
                "block_number": 52000
            },
            "address": "0x07c5779f66fda05ce146747840f18760b1f81188415cb03847e6981e9b65da13",
            "chunk_size": 100
        }
    ]
}

Example

Request

curl <your-endpoint> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '
{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "starknet_getEvents",
    "params": [
        {
            "from_block": {
                "block_number": 51000
            },
            "to_block": {
                "block_number": 52000
            },
            "address": "0x07c5779f66fda05ce146747840f18760b1f81188415cb03847e6981e9b65da13",
            "chunk_size": 100
        }
    ]
}
'

Return

{
    "jsonrpc": "2.0",
    "result": {
        "events": [
            {
                "data": [
                    "0x5aa23d5bb71ddaa783da7ea79d405315bafa7cf0387a74f4593578c3e9e6570"
                ],
                "keys": [
                    "0x2db340e6c609371026731f47050d3976552c89b4fbb012941663841c59d1af3"
                ],
                "from_address": "0x7c5779f66fda05ce146747840f18760b1f81188415cb03847e6981e9b65da13",
                "block_hash": "0x627391f3feb38f137f310b30f3478d9b22ac6c60aa1e1eb9c3468ed3ec94d96",
                "block_number": 51487,
                "transaction_hash": "0x551f9b02e4823a9a95292aaa2b7f53a9100ddaa4e5b7ac01492dc17593b2b6f"
            },
            {
                "data": [
                    "0x1ab123347bb54806a1ca464db841897a72ace74de2fd43a21ca632cb78786f2"
                ],
                "keys": [
                    "0xd876503fb434f7517a7b4ae8d0d5fba27e2fa7b1a9f200deb935316f46fcc3"
                ],
                "from_address": "0x7c5779f66fda05ce146747840f18760b1f81188415cb03847e6981e9b65da13",
                "block_hash": "0x627391f3feb38f137f310b30f3478d9b22ac6c60aa1e1eb9c3468ed3ec94d96",
                "block_number": 51487,
                "transaction_hash": "0x551f9b02e4823a9a95292aaa2b7f53a9100ddaa4e5b7ac01492dc17593b2b6f"
            },
            {
                "data": [
                    "0x2c2b8f559e1221468140ad7b2352b1a5be32660d0bf1a3ae3a054a4ec5254e4"
                ],
                "keys": [
                    "0x2db340e6c609371026731f47050d3976552c89b4fbb012941663841c59d1af3"
                ],
                "from_address": "0x7c5779f66fda05ce146747840f18760b1f81188415cb03847e6981e9b65da13",
                "block_hash": "0x627391f3feb38f137f310b30f3478d9b22ac6c60aa1e1eb9c3468ed3ec94d96",
                "block_number": 51487,
                "transaction_hash": "0x551f9b02e4823a9a95292aaa2b7f53a9100ddaa4e5b7ac01492dc17593b2b6f"
            }
        ]
    },
    "id": 1
}