Class DeployableTargetWithRBAC<Payload, ABI>

A minimal RBAC implementation that offers MANAGER and ADMIN roles, and Budgets and allowlists support this auth scheme

Export

DeployableTargetWithRBAC

Type Parameters

Payload
ABI extends Abi

Hierarchy (view full)

DeployableTarget<Payload, ABI>
- DeployableTargetWithRBAC

Constructors

constructor

new DeployableTargetWithRBAC<Payload, ABI>(options, payload?, isBase?): DeployableTargetWithRBAC<Payload, ABI>
Creates an instance of DeployableTarget.
Type Parameters
- Payload
- ABI extends Abi
Parameters
- options: DeployableOptions
- Optionalpayload: DeployablePayloadOrAddress<Payload>
  Either a given implementation's initialization payload, or an address to an existing on chain target.
- OptionalisBase: boolean
  A property asserting that the protocol should eiher clone and initialize a new target from the base implementation, or re-use an existing contract without initializing.
Returns DeployableTargetWithRBAC<Payload, ABI>
Inherited from DeployableTarget.constructor
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:84

Properties

`Static` `Readonly`bases

bases: Record<number, `0x${string}`> = {}

A static property representing a map of stringified chain ID's to the address of the base implementation on chain, used when cloning base contracts.

Static

`Static` `Readonly`registryType

registryType: RegistryType = RegistryType.ACTION

The target's registry type.

Static

`Readonly`_isBase

_isBase: boolean = true

A property asserting that the protocol should eiher clone and initialize a new target from the base implementation, or re-use an existing contract without initializing.

`Readonly`abi

abi: ABI

`Protected`_payload

_payload: undefined | Payload

The deployable payload used either for contract construction or initialization

`Protected`_config

_config: Config

See

Wagmi Configuration

`Protected`_address

_address: undefined | `0x${string}`

The internally managed address for this contract

`Protected` `Optional`_account

_account?: Account

If it exists, Viem Local Account, if in a Node environment

Accessors

isBase

get isBase(): boolean
Returns boolean
Inherited from DeployableTarget.isBase
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:64

bases

get bases(): Record<number, `0x${string}`>
A getter that will return the base implementation's static addresses by numerical chain ID

Returns Record<number, `0x${string}`>
Inherited from DeployableTarget.bases
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:111

registryType

get registryType(): RegistryType
A getter that returns the registry type of the base implementation

Returns RegistryType
Inherited from DeployableTarget.registryType
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:122

payload

get payload(): undefined | Payload
Returns the attached deployable payload, if it exists

Returns undefined | Payload
Inherited from DeployableTarget.payload
- Defined in packages/sdk/src/Deployable/Deployable.ts:125

address

get address(): undefined | `0x${string}`
A getter returning this contract's deployed address, if it exists.

Returns undefined | `0x${string}`
Inherited from DeployableTarget.address
- Defined in packages/sdk/src/Deployable/Contract.ts:66

Methods

setAuthorized

setAuthorized(addresses, allowed, params?): Promise<void>
Set the authorized status of the given accounts The mechanism for managing authorization is left to the implementing contract
Parameters
- addresses: `0x${string}`[]
  The accounts to authorize or deauthorize
- allowed: boolean[]
  The authorization status for the given accounts
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<void>
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:78

setAuthorizedRaw

setAuthorizedRaw(addresses, allowed, params?): Promise<{
hash: `0x${string}`;
result: void;
}>
Set the authorized status of the given accounts The mechanism for managing authorization is left to the implementing contract
Parameters
- addresses: `0x${string}`[]
  The accounts to authorize or deauthorize
- allowed: boolean[]
  The authorization status for the given accounts
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<{
hash: `0x${string}`;
result: void;
}>
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:99

grantRoles

grantRoles(address, role, params?): Promise<void>
Grant permissions for a user on the rbac.
Parameters
- address: `0x${string}`
- role: Roles
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<void>
Example
```
await rbac.grantRoles('0xfoo', Roles.MANAGER)
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:129

grantRolesRaw

grantRolesRaw(address, role, params?): Promise<{
hash: `0x${string}`;
result: void;
}>
Grant permissions for a user on the rbac.
Parameters
- address: `0x${string}`
- role: Roles
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<{
hash: `0x${string}`;
result: void;
}>
Example
```
await rbac.grantRoles('0xfoo', Roles.MANAGER)
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:147

revokeRoles

revokeRoles(address, role, params?): Promise<void>
Revoke permissions for a user on the rbac.
Parameters
- address: `0x${string}`
- role: Roles
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<void>
Example
```
await rbac.revokeRoles('0xfoo', Roles.MANAGER)
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:181

revokeRolesRaw

revokeRolesRaw(address, role, params?): Promise<{
hash: `0x${string}`;
result: void;
}>
Revoke permissions for a user on the rbac.
Parameters
- address: `0x${string}`
- role: Roles
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<{
hash: `0x${string}`;
result: void;
}>
Example
```
await rbac.revokeRoles('0xfoo', Roles.MANAGER)
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:203

grantManyRoles

grantManyRoles(addresses, roles, params?): Promise<void>
Grant many accounts permissions on the rbac.
Parameters
- addresses: `0x${string}`[]
- roles: Roles[]
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<void>
Example
```
await rbac.grantManyRoles(['0xfoo', '0xbar], [Roles.MANAGER, Roles.ADMIN])
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:237

grantManyRolesRaw

grantManyRolesRaw(addresses, roles, params?): Promise<{
hash: `0x${string}`;
result: void;
}>
Grant many accounts permissions on the rbac.
Parameters
- addresses: `0x${string}`[]
- roles: Roles[]
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<{
hash: `0x${string}`;
result: void;
}>
Example
```
await rbac.grantManyRoles(['0xfoo', '0xbar], [Roles.MANAGER, Roles.ADMIN])
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:261

revokeManyRoles

revokeManyRoles(addresses, roles, params?): Promise<void>
Revoke many accounts' permissions on the rbac.
Parameters
- addresses: `0x${string}`[]
- roles: Roles[]
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<void>
Example
```
await rbac.revokeManyRoles(['0xfoo', '0xbar], [Roles.MANAGER, Roles.ADMIN])
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:295

revokeManyRolesRaw

revokeManyRolesRaw(addresses, roles, params?): Promise<{
hash: `0x${string}`;
result: void;
}>
Revoke many accounts' permissions on the rbac.
Parameters
- addresses: `0x${string}`[]
- roles: Roles[]
- Optionalparams: Partial<Omit<UnionCompute<UnionStrictOmit<SimulateContractParameters<Abi, string, readonly unknown[], Chain, Chain, (`0x${string}` | Account)>, "chain">> & ChainIdParameter<Config, number> & ConnectorParameter,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<{
hash: `0x${string}`;
result: void;
}>
Example
```
await rbac.revokeManyRoles(['0xfoo', '0xbar], [Roles.MANAGER, Roles.ADMIN])
```
Async
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:319

rolesOf

rolesOf(account, params?): Promise<Roles[]>
Return an array of the roles assigned to the given account.
Parameters
- account: `0x${string}`
- Optionalparams: Partial<Omit<ReadContractParameters,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<Roles[]>
Example
```
(await rbac.rolesOf(0xfoo)).includes(Roles.ADMIN)
```
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:353

hasAnyRole

hasAnyRole(account, roles, params?): Promise<boolean>
Returns whether given account has any of the provided roles bitmap.
Parameters
- account: `0x${string}`
- roles: Roles
- Optionalparams: Partial<Omit<ReadContractParameters,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<boolean>
Example
```
await rbac.hasAnyRole(0xfoo, Roles.ADMIN | Roles.MANAGER)
```
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:379

hasAllRoles

hasAllRoles(account, roles, params?): Promise<boolean>
Returns whether given account has all of the provided roles bitmap.
Parameters
- account: `0x${string}`
- roles: Roles
- Optionalparams: Partial<Omit<ReadContractParameters,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<boolean>
Example
```
await rbac.hasAllRoles(0xfoo, Roles.ADMIN | Roles.MANAGER)
```
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:402

isAuthorized

isAuthorized(account, params?): Promise<boolean>
Check if the given account is authorized to use the rbac
Parameters
- account: `0x${string}`
- Optionalparams: Partial<Omit<ReadContractParameters,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<boolean>
- True if the account is authorized
- Defined in packages/sdk/src/Deployable/DeployableTargetWithRBAC.ts:420

deploy

deploy(payload?, options?, waitParams?): Promise<DeployableTargetWithRBAC<Payload, ABI>>
High level deployment function to deploy and await the contract address. This is mainly a convenience method to easily deploy a contract, but will not initialize a Cloneable, which makes it useless for Boost components. Obviously you can ignore the TS warnings and use this, but you shouldn't in most all cases.
Parameters
- Optionalpayload: Payload
- Optionaloptions: DeployableOptions
- OptionalwaitParams: Omit<WaitForTransactionReceiptParameters, "hash">
Returns Promise<DeployableTargetWithRBAC<Payload, ABI>>
Async
Inherited from DeployableTarget.deploy
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:136

deployRaw

deployRaw(_payload?, _options?): Promise<`0x${string}`>
The lower level contract deployment function that does not await for the transaction receipt. This is mainly a convenience method to easily deploy a contract, but will not initialize a Cloneable, which makes it useless for Boost components. Obviously you can ignore the TS warnings and use this, but you shouldn't in most all cases.
Parameters
- Optional_payload: Payload
- Optional_options: DeployableOptions
Returns Promise<`0x${string}`>
Async
Throws
DeployableAlreadyDeployedError

Throws
DeployableWagmiConfigurationRequiredError

Throws
DeployableMissingPayloadError
Inherited from DeployableTarget.deployRaw
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:155

supportsInterface

supportsInterface(interfaceId, params?): Promise<boolean>
Check if the contract supports the given interface
Parameters
- interfaceId: `0x${string}`
  The interface identifier
- Optionalparams: Partial<Omit<ReadContractParameters,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<boolean>
- True if the contract supports the interface
Async
Inherited from DeployableTarget.supportsInterface
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:180

getComponentInterface

getComponentInterface(params?): Promise<`0x${string}`>
Return a cloneable's unique identifier for downstream consumers to differentiate various targets All implementations must override this function
Parameters
- Optionalparams: Partial<Omit<ReadContractParameters,
      | "address"
      | "abi"
      | "functionName"
      | "args">>
Returns Promise<`0x${string}`>
Async
Inherited from DeployableTarget.getComponentInterface
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:199

withPayload

withPayload(payload): DeployableTargetWithRBAC<Payload, ABI>
Attaches a new payload for use with this deployable's initialization
Parameters
- payload: Payload
Returns DeployableTargetWithRBAC<Payload, ABI>
Inherited from DeployableTarget.withPayload
- Defined in packages/sdk/src/Deployable/Deployable.ts:136

buildParameters

buildParameters(_payload?, _options?): GenericDeployableParams
Base parameter constructor, should return a partial viem.deployContract parameters shape including abi, bytecode, and arguments, if any. Expected to be overridden by protocol contracts.
Parameters
- Optional_payload: Payload
- Optional_options: DeployableOptions
Returns GenericDeployableParams
Inherited from DeployableTarget.buildParameters
- Defined in packages/sdk/src/Deployable/Deployable.ts:220

at

at(address): DeployableTargetWithRBAC<Payload, ABI>
Will set this contract's address and return the instance for chaining. Does not verify that provided address is valid.
Parameters
- address: `0x${string}`
Returns DeployableTargetWithRBAC<Payload, ABI>
Inherited from DeployableTarget.at
- Defined in packages/sdk/src/Deployable/Contract.ts:77

withConfig

withConfig(config): DeployableTargetWithRBAC<Payload, ABI>
Will set this contract's internal Wagmi Configuration and return the instance for chaining.
Parameters
- config: Config
Returns DeployableTargetWithRBAC<Payload, ABI>
Inherited from DeployableTarget.withConfig
- Defined in packages/sdk/src/Deployable/Contract.ts:89

assertValidAddress

assertValidAddress(): `0x${string}`
Utility function to validate the existence of an address on this Contract.

Returns `0x${string}`
Throws
ContractAddressRequiredError if no address exists on this Contract instance
Inherited from DeployableTarget.assertValidAddress
- Defined in packages/sdk/src/Deployable/Contract.ts:101

getLogs

getLogs<event, const abiEvent>(params?): Promise<GetLogsReturnType<abiEvent, abiEvent[]>>
A typed wrapper for (viem.getLogs)[https://viem.sh/docs/actions/public/getLogs#getlogs]. Accepts eventName and eventNames as optional parameters to narrow the returned log types.
Type Parameters
- event extends string
- const abiEvent extends {
      name: event;
  } & AbiEvent = Extract<Extract<ABI[number], {
      type: "event";
  }>, {
      name: event;
  }>
Parameters
- Optionalparams: Omit<GetLogsParams<ABI, event, abiEvent, abiEvent[]>, "event" | "events"> & {
  eventName?: event;
  eventNames?: event[];
  }
Returns Promise<GetLogsReturnType<abiEvent, abiEvent[]>>
Example
```
const logs = contract.getLogs({ eventName: 'EventName' })
const logs = contract.getLogs({ eventNames: ['EventName'] })

@public
@async
@template {ContractEvent} event
@template {ExtractAbiEvent<
      ContractAbi,
      event
    >} [abiEvent=ExtractAbiEvent<ContractAbi, event>]
@param {?Omit<
      GetLogsParams<ContractAbi, event, abiEvent, abiEvent[]>,
      'event' | 'events'
    > & {
      eventName?: event;
      eventNames?: event[];
    }} [params]
@returns {Promise<GetLogsReturnType<abiEvent, abiEvent
```
Inherited from DeployableTarget.getLogs
- Defined in packages/sdk/src/Deployable/Contract.ts:131

subscribe<event>(cb, params?): (() => void)
A typed wrapper for wagmi.watchContractEvent
Type Parameters
- event extends string
Parameters
- cb: ((log: WatchContractEventOnLogsParameter<ABI, event, true>[number]) => unknown)
  - - (log): unknown
    - Parameters
      log: WatchContractEventOnLogsParameter<ABI, event, true>[number]
      Returns unknown
- Optionalparams: Partial<Omit<UnionCompute<WatchContractEventParameters<ABI, event, undefined, WebSocketTransport> & ChainIdParameter<Config, number> & SyncConnectedChainParameter>, "address" | "abi">> & {
  eventName?: event;
  }
Returns (() => void)
- - (): void
  - Returns void
Inherited from DeployableTarget.subscribe
- Defined in packages/sdk/src/Deployable/Contract.ts:186

`Protected`validateDeploymentConfig

validateDeploymentConfig<P>(_payload?, _options?): [P, DeployableOptions]
Protected
Internal method used to ensure that a Wagmi configuration and payload are always present when deploying.
Type Parameters
- P = Payload
Parameters
- Optional_payload: P
- Optional_options: DeployableOptions
Returns [P, DeployableOptions]
Throws
DeployableWagmiConfigurationRequiredError

Throws
DeployableMissingPayloadError
Inherited from DeployableTarget.validateDeploymentConfig
- Defined in packages/sdk/src/Deployable/DeployableTarget.ts:218

`Protected`optionallyAttachAccount

optionallyAttachAccount(account?): {
account: Account;
} | {
account: undefined;
}
Protected
Internal function to attach the connected account to write methods to avoid manually passing in an account each call.
Parameters
- Optionalaccount: Account
Returns {
account: Account;
} | {
account: undefined;
}
Inherited from DeployableTarget.optionallyAttachAccount
- Defined in packages/sdk/src/Deployable/Deployable.ts:206

`Protected`awaitResult

awaitResult<Result>(hashPromise, waitParams?): Promise<Result>
Protected
Type Parameters
- Result = unknown
Parameters
- hashPromise: Promise<HashAndSimulatedResult<Result>>
- OptionalwaitParams: Omit<WaitForTransactionReceiptParameters, "hash">
Returns Promise<Result>
See
awaitResult

Async
Inherited from DeployableTarget.awaitResult
- Defined in packages/sdk/src/Deployable/Contract.ts:222

Class DeployableTargetWithRBAC<Payload, ABI>

Export

Type Parameters

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Type Parameters

Parameters

Returns DeployableTargetWithRBAC<Payload, ABI>

Properties

Static Readonlybases

Static

Static ReadonlyregistryType

Static

Readonly_isBase

Readonlyabi

Protected_payload

Protected_config

See

Protected_address

Protected Optional_account

Accessors

isBase

Returns boolean

bases

Returns Record<number, `0x${string}`>

registryType

Returns RegistryType

payload

Returns undefined | Payload

address

Returns undefined | `0x${string}`

Methods

setAuthorized

Parameters

Returns Promise<void>

Async

setAuthorizedRaw

Parameters

Returns Promise<{ hash: `0x${string}`; result: void; }>

Async

grantRoles

Parameters

Returns Promise<void>

Example

Async

grantRolesRaw

Parameters

Returns Promise<{ hash: `0x${string}`; result: void; }>

Example

Async

revokeRoles

Parameters

Returns Promise<void>

Example

Async

revokeRolesRaw

Parameters

Returns Promise<{ hash: `0x${string}`; result: void; }>

Example

Async

grantManyRoles

Parameters

Returns Promise<void>

Example

Async

grantManyRolesRaw

Parameters

Returns Promise<{ hash: `0x${string}`; result: void; }>

Example

Async

revokeManyRoles

Parameters

Returns Promise<void>

Example

`Static` `Readonly`bases

`Static` `Readonly`registryType

`Readonly`_isBase

`Readonly`abi

`Protected`_payload

`Protected`_config

`Protected`_address

`Protected` `Optional`_account

Returns Promise<{
hash: `0x${string}`;
result: void;
}>

Returns Promise<{
hash: `0x${string}`;
result: void;
}>

Returns Promise<{
hash: `0x${string}`;
result: void;
}>

Returns Promise<{
hash: `0x${string}`;
result: void;
}>

Returns Promise<{
hash: `0x${string}`;
result: void;
}>

`Protected`validateDeploymentConfig