OZBuilders

public enum OZBuilders

Builder utilities for OpenZeppelin smart account context rules.

Provides type-safe constructors and display utilities for OZContextRuleType and related OZ-specific operations. These functions are separated from OZSmartAccountBuilders to avoid a circular dependency between core and OZ types.

OZBuilders is a caseless enum used as a namespace; it cannot be instantiated.

Show on GitHub

Context Rule Type Builders

createDefaultContextType()
Creates a default context rule type.

Default rules apply to any operation that does not match a more specific callContract or createContract rule.
Declaration
Swift

public static func createDefaultContextType() -> OZContextRuleType
Return Value

defaultRule for default authorization.

Show on GitHub


                    
                    
                    createCallContractContextType(contractAddress:)

Creates a call-contract context rule type.

Call-contract rules apply only when invoking a specific contract. Useful for restricting signers to specific dApps or operations.

Throws

InvalidAddress if the contract address format is invalid.

Declaration

Swift

public static func createCallContractContextType(contractAddress: String) throws -> OZContextRuleType

Parameters


                                contractAddress

Contract address this rule applies to (C…).

Return Value

An callContract(contractAddress:) configured for the supplied contract.

Show on GitHub


                    
                    
                    createCreateContractContextType(wasmHashHex:)

Creates a create-contract context rule type from a hex-encoded WASM hash.

Create-contract rules apply only when deploying contracts with a specific WASM hash.

Throws

InvalidInput when the hex string is not exactly 64 characters after stripping any 0x prefix or when it contains non-hex characters.

Declaration

Swift

public static func createCreateContractContextType(wasmHashHex: String) throws -> OZContextRuleType

Parameters


                                wasmHashHex

WASM hash as a 64-character hex string (an optional 0x prefix is accepted and stripped).

Return Value

An createContract(wasmHash:) for the supplied hash.

Show on GitHub


                    
                    
                    createCreateContractContextType(wasmHash:)

Creates a create-contract context rule type from raw WASM hash bytes.

Create-contract rules apply only when deploying contracts with a specific WASM hash.

Throws

InvalidInput when wasmHash is not exactly 32 bytes.

Declaration

Swift

public static func createCreateContractContextType(wasmHash: Data) throws -> OZContextRuleType

Parameters


                                wasmHash

32-byte WASM hash.

Return Value

An createContract(wasmHash:) for the supplied hash.

Show on GitHub

Signer Inspection Utilities


                    
                    
                    collectUniqueSignersFromRules(rules:)

Collects unique signers across a list of parsed context rules.

Iterates through the supplied rules, gathers each rule’s signers, and returns a deduplicated list preserving the first occurrence of each signer. Deduplication uses uniqueKey and shares the implementation with collectUniqueSigners(signers:).

Declaration

Swift

public static func collectUniqueSignersFromRules(
    rules: [OZParsedContextRule]
) -> [any OZSmartAccountSigner]

Parameters


                                rules

The parsed context rules to scan.

Return Value

Unique signers across all rules, in first-occurrence order.

Show on GitHub