GnosisSafeL2
BNB Smart Chain0xecc90d54b10add1ab746abe7e83abe178b72aa9e
Proxy implementation: 0x3e5c63644e683549055b9be8653de26e0b4cd36e
Solidity v0.7.6+commit.7338295f
🤖
Query this contract from your AI
Reference:
0xecc90d54b10add1ab746abe7e83abe178b72aa9e
Sample prompt:
“Tell me the current state of bnb/0xecc90d54b10add1ab746abe7e83abe178b72aa9e”
No AI wired up yet? →
mcp.smarts.md
Overview
Read Functions
16
Write Functions
15
Events
17
Read Functions
Block #100,299,433 · just now
VERSION()
view
→ 1.3.0
Returns the current contract version string.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | string | A string containing the contract version identifier, e.g. a semantic version or build tag.✨ AI |
approvedHashes(address, bytes32)
view
Get the uint256 approval marker for a given owner address and data hash.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| — | address | |
| — | bytes32 |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | Approval marker (uint256) for the owner and hash; contract-specific meaning (e.g., 0 = not approved, non-zero = approved).✨ AI |
checkNSignatures(dataHash: bytes32, data: bytes, signatures: bytes, requiredSignatures: uint256)
view
Checks that the provided signatures meet the required number for the given data hash.✨ AI
dev: Checks whether the signature provided is valid for the provided data, hash. Will revert otherwise.
Parameters
| Name | Type | Description |
|---|---|---|
| dataHash | bytes32 | Hash of the data (could be either a message hash or transaction hash) |
| data | bytes | That should be signed (this is passed to an external validator contract) |
| signatures | bytes | Signature data that should be verified. Can be ECDSA signature, contract signature (EIP-1271) or approved hash. |
| requiredSignatures | uint256 | Amount of required valid signatures. |
checkSignatures(dataHash: bytes32, data: bytes, signatures: bytes)
view
Checks that the provided signatures are valid for the given data hash and payload.✨ AI
dev: Checks whether the signature provided is valid for the provided data, hash. Will revert otherwise.
Parameters
| Name | Type | Description |
|---|---|---|
| dataHash | bytes32 | Hash of the data (could be either a message hash or transaction hash) |
| data | bytes | That should be signed (this is passed to an external validator contract) |
| signatures | bytes | Signature data that should be verified. Can be ECDSA signature, contract signature (EIP-1271) or approved hash. |
domainSeparator()
view
→ 0x3a3206a3a2022e0b286ab56aa5e8e14dd42bf4eb5d7b63b393a016aefba38108
Returns the EIP-712 domain separator used to compute typed data hashes for signatures.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | The current EIP-712 domain separator as a bytes32 value, used to derive message hashes for off-chain signatures.✨ AI |
encodeTransactionData(to: address, value: uint256, data: bytes, operation: uint8, safeTxGas: uint256, baseGas: uint256, gasPrice: uint256, gasToken: address, refundReceiver: address, _nonce: uint256)
view
Encode Safe transaction fields into a single bytes payload for signing or execution.✨ AI
dev: Returns the bytes that are hashed to be signed by owners.
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | Destination address. |
| value | uint256 | Ether value. |
| data | bytes | Data payload. |
| operation | uint8 | Operation type. |
| safeTxGas | uint256 | Gas that should be used for the safe transaction. |
| baseGas | uint256 | Gas costs for that are independent of the transaction execution(e.g. base transaction fee, signature check, payment of the refund) |
| gasPrice | uint256 | Maximum gas price that should be used for this transaction. |
| gasToken | address | Token address (or 0 if ETH) that is used for the payment. |
| refundReceiver | address | Address of receiver of gas payment (or 0 if tx.origin). |
| _nonce | uint256 | Transaction nonce. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes | Transaction hash bytes. |
getChainId()
view
→ 56
Returns the current blockchain chain ID.✨ AI
dev: Returns the chain id used by this contract.
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | The numeric chain ID of the blockchain as a uint256.✨ AI |
getModulesPaginated(start: address, pageSize: uint256)
view
Return a paginated list of enabled module addresses starting after the given start address.✨ AI
dev: Returns array of modules.
Parameters
| Name | Type | Description |
|---|---|---|
| start | address | Start of the page. |
| pageSize | uint256 | Maximum number of modules that should be returned. |
Returns
| Name | Type | Description |
|---|---|---|
| array | address[] | array Array of modules. |
| next | address | next Start of the next page. |
getOwners()
view
→ [0xc1273815a5a9f8be595170f697734e3f0b8fc07d, 0xa7c61ccd45795694f80fc55bf6109e093641550b, 0x27cb14cdfa31f6be86701b429f81f0663fc99006, 0x08fc23075b0d07132bdea75864233062e9cc56b2, 0x897fa2c8a2628b657cb2b4c093cfcff86212059b, 0xb30df86de0e1b321451809cccebf5651dff7b900, 0xd09971d8ed6c6a5e57581e90d593ee5b94e348d4]
Returns the list of owner addresses for this Gnosis Safe.✨ AI
dev: Returns array of owners.
Returns
| Name | Type | Description |
|---|---|---|
| — | address[] | Array of Safe owners. |
getStorageAt(offset: uint256, length: uint256)
view
Read raw contract storage starting at the specified storage slot offset and return the requested bytes.✨ AI
dev: Reads `length` bytes of storage in the currents contract
Parameters
| Name | Type | Description |
|---|---|---|
| offset | uint256 | - the offset in the current contract's storage in words to start reading from |
| length | uint256 | - the number of words (32 bytes) of data to read |
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes | the bytes that were read. |
getThreshold()
view
→ 3
Returns the current approval threshold required to execute a transaction.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | The uint256 number of owner confirmations required to execute a safe transaction.✨ AI |
getTransactionHash(to: address, value: uint256, data: bytes, operation: uint8, safeTxGas: uint256, baseGas: uint256, gasPrice: uint256, gasToken: address, refundReceiver: address, _nonce: uint256)
view
Compute the deterministic hash of a Safe transaction for signing or on-chain verification.✨ AI
dev: Returns hash to be signed by owners.
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | Destination address. |
| value | uint256 | Ether value. |
| data | bytes | Data payload. |
| operation | uint8 | Operation type. |
| safeTxGas | uint256 | Fas that should be used for the safe transaction. |
| baseGas | uint256 | Gas costs for data used to trigger the safe transaction. |
| gasPrice | uint256 | Maximum gas price that should be used for this transaction. |
| gasToken | address | Token address (or 0 if ETH) that is used for the payment. |
| refundReceiver | address | Address of receiver of gas payment (or 0 if tx.origin). |
| _nonce | uint256 | Transaction nonce. |
Returns
| Name | Type | Description |
|---|---|---|
| — | bytes32 | Transaction hash. |
isModuleEnabled(module: address)
view
Checks whether a module address is enabled in the Gnosis Safe and returns true if enabled.✨ AI
dev: Returns if an module is enabled
Parameters
| Name | Type | Description |
|---|---|---|
| module | address | Address of the module to check.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the module is enabled |
isOwner(owner: address)
view
Returns whether the given address is an owner of the safe.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | Address to check for owner status.✨ AI |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the address is an owner, otherwise false.✨ AI |
nonce()
view
→ 4,617
Return the current nonce for the safe used to order transactions and prevent replay attacks.✨ AI
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | The current uint256 nonce of the safe; increments after each executed transaction to prevent replays.✨ AI |
signedMessages(bytes32)
view
Return the uint256 value stored for a given message hash.✨ AI
Parameters
| Name | Type | Description |
|---|---|---|
| — | bytes32 |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | The uint256 value associated with the given message hash.✨ AI |
Write Functions
addOwnerWithThreshold(owner: address, _threshold: uint256)
nonpayable
Adds the owner `owner` to the Safe and updates the threshold to `_threshold`.
dev: Allows to add a new owner to the Safe and update the threshold at the same time. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| owner | address | New owner address. |
| _threshold | uint256 | New threshold. |
approveHash(hashToApprove: bytes32)
nonpayable
Record approval of a transaction hash by the caller.✨ AI
dev: Marks a hash as approved. This can be used to validate a hash that is used by a signature.
Parameters
| Name | Type | Description |
|---|---|---|
| hashToApprove | bytes32 | The hash that should be marked as approved for signatures that are verified by this contract. |
changeThreshold(_threshold: uint256)
nonpayable
Changes the threshold of the Safe to `_threshold`.
dev: Allows to update the number of required confirmations by Safe owners. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| _threshold | uint256 | New threshold. |
disableModule(prevModule: address, module: address)
nonpayable
Disables the module `module` for the Safe.
dev: Allows to remove a module from the whitelist. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| prevModule | address | Module that pointed to the module to be removed in the linked list |
| module | address | Module to be removed. |
enableModule(module: address)
nonpayable
Enables the module `module` for the Safe.
dev: Allows to add a module to the whitelist. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| module | address | Module to be whitelisted. |
execTransaction(to: address, value: uint256, data: bytes, operation: uint8, safeTxGas: uint256, baseGas: uint256, gasPrice: uint256, gasToken: address, refundReceiver: address, signatures: bytes)
payable
Execute a Safe transaction with provided calldata, gas settings, and signatures.✨ AI
dev: Allows to execute a Safe transaction confirmed by required number of owners and then pays the account that submitted the transaction. Note: The fees are always transferred, even if the user transaction fails.
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | Destination address of Safe transaction. |
| value | uint256 | Ether value of Safe transaction. |
| data | bytes | Data payload of Safe transaction. |
| operation | uint8 | Operation type of Safe transaction. |
| safeTxGas | uint256 | Gas that should be used for the Safe transaction. |
| baseGas | uint256 | Gas costs that are independent of the transaction execution(e.g. base transaction fee, signature check, payment of the refund) |
| gasPrice | uint256 | Gas price that should be used for the payment calculation. |
| gasToken | address | Token address (or 0 if ETH) that is used for the payment. |
| refundReceiver | address | Address of receiver of gas payment (or 0 if tx.origin). |
| signatures | bytes | Packed signature data ({bytes32 r}{bytes32 s}{uint8 v}) |
Returns
| Name | Type | Description |
|---|---|---|
| — | bool | True if the transaction was executed successfully, false otherwise.✨ AI |
execTransactionFromModule(to: address, value: uint256, data: bytes, operation: uint8)
nonpayable
Executes a transaction initiated by a module, sending value and data to the specified target address.✨ AI
dev: Allows a Module to execute a Safe transaction without any further confirmations.
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | Destination address of module transaction. |
| value | uint256 | Ether value of module transaction. |
| data | bytes | Data payload of module transaction. |
| operation | uint8 | Operation type of module transaction. |
Returns
| Name | Type | Description |
|---|---|---|
| success | bool | True if the executed call succeeded, false otherwise.✨ AI |
execTransactionFromModuleReturnData(to: address, value: uint256, data: bytes, operation: uint8)
nonpayable
Execute a transaction requested by a module and return whether it succeeded and the returned data.✨ AI
dev: Allows a Module to execute a Safe transaction without any further confirmations and return data
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | Destination address of module transaction. |
| value | uint256 | Ether value of module transaction. |
| data | bytes | Data payload of module transaction. |
| operation | uint8 | Operation type of module transaction. |
Returns
| Name | Type | Description |
|---|---|---|
| success | bool | Whether the executed transaction succeeded (true) or failed (false).✨ AI |
| returnData | bytes | Raw bytes returned by the executed call, e.g. return data or revert reason.✨ AI |
removeOwner(prevOwner: address, owner: address, _threshold: uint256)
nonpayable
Removes the owner `owner` from the Safe and updates the threshold to `_threshold`.
dev: Allows to remove an owner from the Safe and update the threshold at the same time. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| prevOwner | address | Owner that pointed to the owner to be removed in the linked list |
| owner | address | Owner address to be removed. |
| _threshold | uint256 | New threshold. |
requiredTxGas(to: address, value: uint256, data: bytes, operation: uint8)
nonpayable
Deprecated in favor of common/StorageAccessible.sol and will be removed in next version.
dev: Allows to estimate a Safe transaction. This method is only meant for estimation purpose, therefore the call will always revert and encode the result in the revert data. Since the `estimateGas` function includes refunds, call this method to get an estimated of the costs that are deducted from the safe with `execTransaction`
Parameters
| Name | Type | Description |
|---|---|---|
| to | address | Destination address of Safe transaction. |
| value | uint256 | Ether value of Safe transaction. |
| data | bytes | Data payload of Safe transaction. |
| operation | uint8 | Operation type of Safe transaction. |
Returns
| Name | Type | Description |
|---|---|---|
| — | uint256 | Estimate without refunds and overhead fees (base transaction and payload data gas costs). |
setFallbackHandler(handler: address)
nonpayable
Set the fallback handler address that processes calls that do not match any contract function.✨ AI
dev: Allows to add a contract to handle fallback calls. Only fallback calls without value and with data will be forwarded. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| handler | address | contract to handle fallbacks calls. |
setGuard(guard: address)
nonpayable
Sets the guard address that will be consulted to validate transactions before execution.✨ AI
dev: Set a guard that checks transactions before execution
Parameters
| Name | Type | Description |
|---|---|---|
| guard | address | The address of the guard to be used or the 0 address to disable the guard |
setup(_owners: address[], _threshold: uint256, to: address, data: bytes, fallbackHandler: address, paymentToken: address, payment: uint256, paymentReceiver: address)
nonpayable
Set up the Safe by providing owners, the confirmation threshold, and an optional initialization call.✨ AI
dev: Setup function sets initial storage of contract.
Parameters
| Name | Type | Description |
|---|---|---|
| _owners | address[] | List of Safe owners. |
| _threshold | uint256 | Number of required confirmations for a Safe transaction. |
| to | address | Contract address for optional delegate call. |
| data | bytes | Data payload for optional delegate call. |
| fallbackHandler | address | Handler for fallback calls to this contract |
| paymentToken | address | Token that should be used for the payment (0 is ETH) |
| payment | uint256 | Value that should be paid |
| paymentReceiver | address | Adddress that should receive the payment (or 0 if tx.origin) |
simulateAndRevert(targetContract: address, calldataPayload: bytes)
nonpayable
Simulate a call to a target contract using provided calldata and revert to avoid state changes.✨ AI
dev: Performs a delegetecall on a targetContract in the context of self. Internally reverts execution to avoid side effects (making it static). This method reverts with data equal to `abi.encode(bool(success), bytes(response))`. Specifically, the `returndata` after a call to this method will be: `success:bool || response.length:uint256 || response:bytes`.
Parameters
| Name | Type | Description |
|---|---|---|
| targetContract | address | Address of the contract containing the code to execute. |
| calldataPayload | bytes | Calldata that should be sent to the target contract (encoded method name and arguments). |
swapOwner(prevOwner: address, oldOwner: address, newOwner: address)
nonpayable
Replaces the owner `oldOwner` in the Safe with `newOwner`.
dev: Allows to swap/replace an owner from the Safe with another address. This can only be done via a Safe transaction.
Parameters
| Name | Type | Description |
|---|---|---|
| prevOwner | address | Owner that pointed to the owner to be replaced in the linked list |
| oldOwner | address | Owner address to be replaced. |
| newOwner | address | New owner address. |
Events
AddedOwner(owner: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| owner | address |
ApproveHash(approvedHash: bytes32, owner: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| approvedHash | bytes32 | ✓ | |
| owner | address | ✓ |
ChangedFallbackHandler(handler: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| handler | address |
ChangedGuard(guard: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| guard | address |
ChangedThreshold(threshold: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| threshold | uint256 |
DisabledModule(module: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| module | address |
EnabledModule(module: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| module | address |
ExecutionFailure(txHash: bytes32, payment: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| txHash | bytes32 | ||
| payment | uint256 |
ExecutionFromModuleFailure(module: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| module | address | ✓ |
ExecutionFromModuleSuccess(module: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| module | address | ✓ |
ExecutionSuccess(txHash: bytes32, payment: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| txHash | bytes32 | ||
| payment | uint256 |
RemovedOwner(owner: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| owner | address |
SafeModuleTransaction(module: address, to: address, value: uint256, data: bytes, operation: uint8)
| Name | Type | Indexed | Description |
|---|---|---|---|
| module | address | ||
| to | address | ||
| value | uint256 | ||
| data | bytes | ||
| operation | uint8 |
SafeMultiSigTransaction(to: address, value: uint256, data: bytes, operation: uint8, safeTxGas: uint256, baseGas: uint256, gasPrice: uint256, gasToken: address, refundReceiver: address, signatures: bytes, additionalInfo: bytes)
| Name | Type | Indexed | Description |
|---|---|---|---|
| to | address | ||
| value | uint256 | ||
| data | bytes | ||
| operation | uint8 | ||
| safeTxGas | uint256 | ||
| baseGas | uint256 | ||
| gasPrice | uint256 | ||
| gasToken | address | ||
| refundReceiver | address | ||
| signatures | bytes | ||
| additionalInfo | bytes |
SafeReceived(sender: address, value: uint256)
| Name | Type | Indexed | Description |
|---|---|---|---|
| sender | address | ✓ | |
| value | uint256 |
SafeSetup(initiator: address, owners: address[], threshold: uint256, initializer: address, fallbackHandler: address)
| Name | Type | Indexed | Description |
|---|---|---|---|
| initiator | address | ✓ | |
| owners | address[] | ||
| threshold | uint256 | ||
| initializer | address | ||
| fallbackHandler | address |
SignMsg(msgHash: bytes32)
| Name | Type | Indexed | Description |
|---|---|---|---|
| msgHash | bytes32 | ✓ |