Confidential Contracts

https://docs.openzeppelin.com/confidential-contracts
Admin
A library of smart contracts that leverage ciphertext for amounts, enabling a wide range of...
Tokens:44,706
Snippets:485
Trust Score:10
Update:1 month ago
Show doc for...
Tokens:
Raw
### _onInstall(address, bytes)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Internal function which may be overridden by the derived contract to perform actions when the module is installed. Should clean up dirty state from possible previous installations.

```APIDOC
## `_onInstall(address, bytes)`

### Description
Internal function which may be overridden by the derived contract to perform actions when the module is installed. Should clean up dirty state from possible previous installations.

### Method
internal

### Parameters
- **address** (address) - Required - The address of the token.
- **bytes** (bytes) - Required - The initialization data.

```

--------------------------------

### start

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Returns the timestamp at which the vesting starts.

```APIDOC
## start

### Description
Returns the timestamp at which the vesting starts.

### Method
start() → uint64

### Visibility
public

### Returns
- uint64: The start timestamp.
```

--------------------------------

### onInstall(bytes initData)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Performs operations after installation.

```APIDOC
## `onInstall(bytes initData)`

### Description
Performs operations after installation.

### Method
public

### Parameters
- **initData** (bytes) - Required - The initialization data for the module.

```

--------------------------------

### IERC7984HookModule.onInstall

Source: https://docs.openzeppelin.com/confidential-contracts/api/interfaces

Performs operations after installation.

```APIDOC
## onInstall(bytes initData)

### Description
Performs operations after installation.

### Function Signature
`onInstall(bytes initData)`

### Parameters
- **initData** (bytes) - Initialization data.

### Behavior
external

```

--------------------------------

### modules(start, end)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Returns a list of installed modules within the specified range.

```APIDOC
## modules(start, end)

### Description
Returns a list of installed modules within the specified range.

### Function Signature
`modules(start, end)`

### Parameters
- **start** (uint256) - Required - The starting index of the module list.
- **end** (uint256) - Required - The ending index of the module list.

### Returns
- **address[]** - Array of module addresses.
```

--------------------------------

### _onInstall(address token, bytes initData)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Internal function to install the module. The `initData` must contain the initial max balance for the token along with the input proof for the max balance, encoded using standard ABI encoding.

```APIDOC
## _onInstall(address token, bytes initData)

### Description
See `ERC7984HookModule._onInstall`. The `initData` must contain the initial max balance for the token along with the input proof for the max balance. These are encoded using standard ABI encoding.

### Method
internal

### Parameters
- **token** (address) - Required - The token address.
- **initData** (bytes) - Required - The encoded initial max balance and input proof.

### Response
No return value.
```

--------------------------------

### maxModules()

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Returns the maximum number of modules that can be installed.

```APIDOC
## maxModules()

### Description
Returns the maximum number of modules that can be installed.

### Function Signature
`maxModules()`

### Parameters
- None

### Returns
- **uint256** - The maximum number of modules.
```

--------------------------------

### installModule(module, initData)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Installs a new hook module on the token contract, passing initialization data to the module.

```APIDOC
## installModule(module, initData)

### Description
Installs a new hook module on the token contract, passing initialization data to the module.

### Function Signature
`installModule(module, initData)`

### Parameters
- **module** (address) - Required - The address of the module to install.
- **initData** (bytes) - Required - Initialization data to pass to the module.

### Returns
- None
```

--------------------------------

### __VestingWalletConfidential_init

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Initializes the vesting wallet for a given `beneficiary` with a start time of `startTimestamp` and an end time of `startTimestamp + durationSeconds`.

```APIDOC
## __VestingWalletConfidential_init

### Description
Initializes the vesting wallet for a given `beneficiary` with a start time of `startTimestamp` and an end time of `startTimestamp + durationSeconds`.

### Method
__VestingWalletConfidential_init(address beneficiary, uint48 startTimestamp, uint48 durationSeconds)

### Visibility
internal

### Parameters
- beneficiary address: The beneficiary address.
- startTimestamp uint48: The start timestamp.
- durationSeconds uint48: The duration in seconds.
```

--------------------------------

### Set Bob as Alice's operator for 24 hours (using wallet alice)

Source: https://docs.openzeppelin.com/confidential-contracts/token

Sets an operator for a duration using an expiration timestamp. The example shows the `setOperator` call with a wallet connected to the token contract. Operators can take all tokens, so vet them carefully.

```typescript
const alice: Wallet;
const expirationTimestamp = Math.round(Date.now()) + 60 * 60 * 24; // Now + 24 hours

await tokenContract.connect(alice).setOperator(bob, expirationTimestamp);
```

--------------------------------

### _getTokenHandleAllowance(address token, euint64 handle, bool persistent)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Allow modules to get access to token handles.

```APIDOC
## `_getTokenHandleAllowance(address token, euint64 handle, bool persistent)`

### Description
Allow modules to get access to token handles.

### Method
internal

### Parameters
- **token** (address) - Required - The token address.
- **handle** (euint64) - Required - The handle to get access to.
- **persistent** (bool) - Required - Whether the access is persistent.

```

--------------------------------

### _getTokenHandleAllowance(address token, euint64 handle)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Allow modules to get access to token handles during transaction.

```APIDOC
## `_getTokenHandleAllowance(address token, euint64 handle)`

### Description
Allow modules to get access to token handles during transaction.

### Method
internal

### Parameters
- **token** (address) - Required - The token address.
- **handle** (euint64) - Required - The handle to get access to.

```

--------------------------------

### isModuleInstalled(module)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Checks whether a given module is installed on the token contract.

```APIDOC
## isModuleInstalled(module)

### Description
Checks whether a given module is installed on the token contract.

### Function Signature
`isModuleInstalled(module)`

### Parameters
- **module** (address) - Required - The address of the module to check.

### Returns
- **bool** - True if the module is installed, false otherwise.
```

--------------------------------

### _reentrancyGuardStorageSlot

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Internal function to get the reentrancy guard storage slot.

```APIDOC
function _reentrancyGuardStorageSlot() internal pure returns (bytes32)
```

--------------------------------

### _accessHandle(address token, euint64 handle)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Get transient ACL allowance for the given handle from a contract that inherits `HandleAccessManager`. Additionally verifies that the token is authorized to access the handle.

```APIDOC
## `_accessHandle(address token, euint64 handle)`

### Description
Get transient ACL allowance for the given handle from a contract that inherits `HandleAccessManager`. Additionally verifies that the token is authorized to access the handle.

### Method
internal

### Parameters
- **token** (address) - Required - The token address.
- **handle** (euint64) - Required - The handle to get access to.

```

--------------------------------

### holderCount

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Gets the current number of holders for the given token.

```APIDOC
## holderCount(address token) → euint64

### Description
Gets current number of holders for the given token `token`.

### Parameters
- `token` (address) - The token address.

### Returns
- `euint64` - The current number of holders for the token.

```

--------------------------------

### maxHolderCount

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Gets the maximum number of holders for the given token.

```APIDOC
## maxHolderCount(address token) → uint64

### Description
Gets max number of holders for the given token `token`.

### Parameters
- `token` (address) - The token address.

### Returns
- `uint64` - The max number of holders for the token.

```

--------------------------------

### Import FHESafeMath library

Source: https://docs.openzeppelin.com/confidential-contracts/api/utils

Import the FHESafeMath library to use safe arithmetic operations for encrypted values. The library provides functions like tryIncrease, tryDecrease, tryAdd, trySub, saturatingAdd, and saturatingSub. Note that an uninitialized euint64 value is evaluated as 0, and operations may return an uninitialized value if all inputs are uninitialized.

```solidity
import "@openzeppelin/confidential-contracts/utils/FHESafeMath.sol";
```

--------------------------------

### _getAndIncreaseBatchId

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Internal function to get and increase the current batch ID.

```APIDOC
function _getAndIncreaseBatchId() internal returns (uint256)
```

--------------------------------

### constructor(contract IERC20 underlying_)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Initializes the wrapper contract with the underlying ERC20 token address.

```APIDOC
## constructor(contract IERC20 underlying_)

### Description
Initializes the wrapper contract with the underlying ERC20 token.

### Method
constructor

### Parameters
- `underlying_` (IERC20) - Required - The underlying ERC20 token address.
```

--------------------------------

### __VestingWalletConfidential_init_unchained

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Internal initializer without owner parameter, presumably used by the factory.

```APIDOC
## __VestingWalletConfidential_init_unchained

### Description
Internal initializer without owner parameter, presumably used by the factory.

### Method
__VestingWalletConfidential_init_unchained(uint48 startTimestamp, uint48 durationSeconds)

### Visibility
internal

### Parameters
- startTimestamp uint48: The start timestamp.
- durationSeconds uint48: The duration in seconds.
```

--------------------------------

### fromToken

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Returns the fromToken wrapper.

```APIDOC
function fromToken() external view returns (contract IERC7984ERC20Wrapper)
```

--------------------------------

### Constructor

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Constructor for the BatcherConfidential contract. It initializes the fromToken and toToken wrappers.

```APIDOC
constructor(contract IERC7984ERC20Wrapper fromToken_, contract IERC7984ERC20Wrapper toToken_) internal
```

--------------------------------

### maxBalance(address token)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Gets the encrypted max balance for a given token. Returns the zero handle if unset.

```APIDOC
## maxBalance(address token)

### Description
Gets the encrypted max balance for a given token `token`. Returns the zero handle if unset.

### Method
public

### Parameters
- **token** (address) - Required - The token address.

### Response
- **euint64** - The encrypted max balance.
```

--------------------------------

### Import ERC7984ObserverAccess

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Import the ERC7984ObserverAccess extension from the OpenZeppelin confidential contracts library.

```solidity
import "@openzeppelin/confidential-contracts/token/ERC7984/extensions/ERC7984ObserverAccess.sol";
```

--------------------------------

### toToken

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Returns the toToken wrapper.

```APIDOC
function toToken() external view returns (contract IERC7984ERC20Wrapper)
```

--------------------------------

### dispatchBatch

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Dispatches the current batch.

```APIDOC
function dispatchBatch() external
```

--------------------------------

### Override _erc7821AuthorizedExecutor to Allow ERC-4337 Entrypoint

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Overrides the access control for execute, by default only the contract itself is allowed. This example extends the super implementation to also authorize the ERC-4337 entrypoint as caller.

```solidity
function _erc7821AuthorizedExecutor(
  address caller,
  bytes32 mode,
  bytes calldata executionData
) internal view virtual override returns (bool) {
  return caller == address(entryPoint()) || super._erc7821AuthorizedExecutor(caller, mode, executionData);
}
```

--------------------------------

### CheckpointsConfidential.TraceEuint64.push

Source: https://docs.openzeppelin.com/confidential-contracts/api/utils

Pushes a (key, value) pair into a TraceEuint64 checkpoint. Returns the previous and new values. The key should never be user input to avoid disabling the library.

```APIDOC
## push(struct CheckpointsConfidential.TraceEuint64 self, uint256 key, euint64 value) → euint64 oldValue, euint64 newValue

### Description
Pushes a (key, value) pair into a TraceEuint64 so that it is stored as the checkpoint. Returns previous value and new value. Never accept key as a user input, since an arbitrary type(uint256).max key set will disable the library.

### Visibility
internal

### Parameters
- **self** (struct CheckpointsConfidential.TraceEuint64) - The checkpoint structure.
- **key** (uint256) - The key associated with the checkpoint.
- **value** (euint64) - The value to store.

### Returns
- **oldValue** (euint64) - The previous value.
- **newValue** (euint64) - The new value.
```

--------------------------------

### contractURI()

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Returns the contract URI for metadata.

```APIDOC
## contractURI()

### Description
Returns the contract URI for metadata.

### Function Signature
`contractURI()`

### Parameters
- None

### Returns
- **string** - The contract URI.
```

--------------------------------

### CheckpointsConfidential.TraceEuint32.push

Source: https://docs.openzeppelin.com/confidential-contracts/api/utils

Pushes a (key, value) pair into a TraceEuint32 checkpoint. Returns the previous and new values. The key should never be user input to avoid disabling the library.

```APIDOC
## push(struct CheckpointsConfidential.TraceEuint32 self, uint256 key, euint32 value) → euint32 oldValue, euint32 newValue

### Description
Pushes a (key, value) pair into a TraceEuint32 so that it is stored as the checkpoint. Returns previous value and new value. Never accept key as a user input, since an arbitrary type(uint256).max key set will disable the library.

### Visibility
internal

### Parameters
- **self** (struct CheckpointsConfidential.TraceEuint32) - The checkpoint structure.
- **key** (uint256) - The key associated with the checkpoint.
- **value** (euint32) - The value to store.

### Returns
- **oldValue** (euint32) - The previous value.
- **newValue** (euint32) - The new value.
```

--------------------------------

### unwrap(address from, address to, externalEuint64 encryptedAmount, bytes inputProof) → bytes32

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Unwraps confidential tokens with an encrypted amount and input proof. Underlying tokens equal to `amount * rate()` are sent to `to`, and the request must be finalized via `finalizeUnwrap`.

```APIDOC
## unwrap(address from, address to, externalEuint64 encryptedAmount, bytes inputProof) → bytes32

### Description
Unwraps confidential tokens with an encrypted amount and input proof. The underlying tokens are sent after finalization.

### Method
Function

### Parameters
- `from` (address) - The holder of the confidential tokens.
- `to` (address) - The address to receive the underlying tokens.
- `encryptedAmount` (externalEuint64) - The encrypted amount to unwrap.
- `inputProof` (bytes) - Proof for the input amount.

### Returns
- `bytes32` - The unwrap request ID.
```

--------------------------------

### Import ERC7821WithExecutor

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Shows how to import the ERC7821WithExecutor contract from the OpenZeppelin confidential-contracts finance package.

```solidity
import "@openzeppelin/confidential-contracts/finance/ERC7821WithExecutor.sol";
```

--------------------------------

### CheckpointsConfidential.TraceEuint64.at

Source: https://docs.openzeppelin.com/confidential-contracts/api/utils

Returns checkpoint at given position.

```APIDOC
## at(struct CheckpointsConfidential.TraceEuint64 self, uint32 pos) → uint256 key, euint64 value

### Description
Returns checkpoint at given position.

### Visibility
internal

### Parameters
- **self** (struct CheckpointsConfidential.TraceEuint64) - The checkpoint structure.
- **pos** (uint32) - The position index.

### Returns
- **key** (uint256) - The key at the given position.
- **value** (euint64) - The value at the given position.
```

--------------------------------

### CheckpointsConfidential.TraceEuint32.at

Source: https://docs.openzeppelin.com/confidential-contracts/api/utils

Returns checkpoint at given position.

```APIDOC
## at(struct CheckpointsConfidential.TraceEuint32 self, uint32 pos) → uint256 key, euint32 value

### Description
Returns checkpoint at given position.

### Visibility
internal

### Parameters
- **self** (struct CheckpointsConfidential.TraceEuint32) - The checkpoint structure.
- **pos** (uint32) - The position index.

### Returns
- **key** (uint256) - The key at the given position.
- **value** (euint32) - The value at the given position.
```

--------------------------------

### setObserver(address account, address newObserver)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Sets the observer for a given account. Can be called by the account or the existing observer to abdicate the observer role.

```APIDOC
## setObserver(address account, address newObserver)

### Description
Sets the observer for the given account `account` to `newObserver`. Can be called by the account or the existing observer to abdicate the observer role (may only set to `address(0)`).

### Method
public

### Parameters
- **account** (address) - Required - The account for which the observer is being set.
- **newObserver** (address) - Required - The address of the new observer, or `address(0)` to abdicate.

### Events
- **ERC7984ObserverAccessObserverSet** (account, oldObserver, newObserver) - Emitted when the observer is changed.

### Errors
- **Unauthorized()** - Thrown when an account tries to set a `newObserver` for a given `account` without proper authority.
```

--------------------------------

### observer(address account) → address

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Returns the observer for a given account.

```APIDOC
## observer(address account) → address

### Description
Returns the observer for the given account `account`.

### Method
public

### Parameters
- **account** (address) - Required - The account whose observer is being queried.

### Returns
- **address** - The observer address for the given account.
```

--------------------------------

### deposits

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Returns the deposit amount for a given account in a batch.

```APIDOC
function deposits(uint256 batchId, address account) external view returns (euint64)
```

--------------------------------

### _executeRoute

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Virtual function that must be implemented by developers to perform the batch's route. Called once the batch deposits are unwrapped.

```APIDOC
function _executeRoute(uint256 batchId) internal virtual
```

--------------------------------

### setMaxBalance(address token, externalEuint64 newMaxBalance, bytes inputProof)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Sets the max balance for a given token to the encrypted value. The caller must have the agent role on the token.

```APIDOC
## setMaxBalance(address token, externalEuint64 newMaxBalance, bytes inputProof)

### Description
Sets the max balance for a given token `token` to the encrypted value `newMaxBalance`. `msg.sender` must have the agent role on `token`.

### Method
public

### Parameters
- **token** (address) - Required - The token address.
- **newMaxBalance** (externalEuint64) - Required - The encrypted new max balance.
- **inputProof** (bytes) - Required - The input proof for the new max balance.

### Response
No return value.
```

--------------------------------

### totalDeposits

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Returns the total deposits for a given batch.

```APIDOC
function totalDeposits(uint256 batchId) external view returns (euint64)
```

--------------------------------

### name()

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Returns the name of the token.

```APIDOC
## name()

### Description
Returns the name of the token.

### Function Signature
`name()`

### Parameters
- None

### Returns
- **string** - The token name.
```

--------------------------------

### confidentialTotalSupply()

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Returns the total supply of the token in encrypted form.

```APIDOC
## confidentialTotalSupply()

### Description
Returns the total supply of the token in encrypted form.

### Function Signature
`confidentialTotalSupply()`

### Parameters
- None

### Returns
- **bytes** - The encrypted total supply.
```

--------------------------------

### Import IERC7984Receiver interface

Source: https://docs.openzeppelin.com/confidential-contracts/api/interfaces

Import the IERC7984Receiver interface from the OpenZeppelin Confidential Contracts library. Use this to implement contracts that can receive ERC7984 transfers with a callback.

```solidity
import "@openzeppelin/confidential-contracts/interfaces/IERC7984Receiver.sol";
```

--------------------------------

### _setMaxBalance(address token, euint64 newMaxBalance)

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Internal function that sets the encrypted max balance for a given token, grants the module persistent ACL, and emits an event.

```APIDOC
## _setMaxBalance(address token, euint64 newMaxBalance)

### Description
Sets the encrypted max balance for a given token, grants the module persistent ACL, and emits an event.

### Method
internal

### Parameters
- **token** (address) - Required - The token address.
- **newMaxBalance** (euint64) - Required - The encrypted new max balance.

### Response
No return value.
```

--------------------------------

### delegates(address account)

Source: https://docs.openzeppelin.com/confidential-contracts/api/governance

Returns the delegate that `account` has chosen.

```APIDOC
## delegates(address account)

### Description
Returns the delegate that `account` has chosen.

### Method
public

### Parameters
- `account` (address) - The address to query.

### Returns
- `address` - The delegate address.

```

--------------------------------

### unwrap(address from, address to, euint64 amount) → bytes32

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

Unwraps confidential tokens without an input proof. See the proof-based unwrap for more details.

```APIDOC
## unwrap(address from, address to, euint64 amount) → bytes32

### Description
Unwraps confidential tokens without requiring an input proof.

### Method
Function

### Parameters
- `from` (address) - The holder of the confidential tokens.
- `to` (address) - The address to receive the underlying tokens after unwrapping.
- `amount` (euint64) - The amount of confidential tokens to unwrap.

### Returns
- `bytes32` - The unwrap request ID.
```

--------------------------------

### rate() → uint256

Source: https://docs.openzeppelin.com/confidential-contracts/api/interfaces

Returns the rate at which the underlying token is converted to the wrapped token.

```APIDOC
## rate() → uint256

### Description
Returns the rate at which the underlying token is converted to the wrapped token. For example, if the `rate` is 1000, then 1000 units of the underlying token equal 1 unit of the wrapped token.

### Function Signature
`rate() → uint256`

### Returns
- **uint256** - The conversion rate.

```

--------------------------------

### CLOCK_MODE()

Source: https://docs.openzeppelin.com/confidential-contracts/api/governance

Returns a machine-readable description of the clock as specified in ERC-6372.

```APIDOC
## CLOCK_MODE()

### Description
Returns a machine-readable description of the clock as specified in ERC-6372.

### Method
public

### Returns
- `string` - The clock mode description.

```

--------------------------------

### dispatchBatchCallback

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Callback function for dispatchBatch.

```APIDOC
function dispatchBatchCallback(uint256 batchId, uint256 unwrapAmountCleartext, bytes calldata decryptionProof) external
```

--------------------------------

### Import BatcherConfidential

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Import statement for the BatcherConfidential contract from the confidential-contracts finance package.

```solidity
import "@openzeppelin/confidential-contracts/finance/BatcherConfidential.sol";
```

--------------------------------

### exchangeRate

Source: https://docs.openzeppelin.com/confidential-contracts/api/finance

Returns the exchange rate for a given batch.

```APIDOC
function exchangeRate(uint256 batchId) external view returns (euint64)
```

--------------------------------

### Import ERC7984ERC20Wrapper

Source: https://docs.openzeppelin.com/confidential-contracts/api/token

This snippet imports the ERC7984ERC20Wrapper contract. Use it when building on top of the wrapper to enable wrapping ERC20 tokens with ERC7984.

```solidity
import "@openzeppelin/confidential-contracts/token/ERC7984/extensions/ERC7984ERC20Wrapper.sol";
```

--------------------------------

### Wrap ERC-20 to ERC-7984

Source: https://docs.openzeppelin.com/confidential-contracts/token

An excerpt from the wrap function showing how to transfer an underlying ERC-20 token and mint a corresponding confidential ERC-7984 token.

```solidity
function wrap(address to, uint256 amount) public virtual {
    // take ownership of the tokens
    SafeERC20.safeTransferFrom(underlying(), msg.sender, address(this), amount - (amount % rate()));

    // mint confidential token
    _mint(to, (amount / rate()).toUint64().asEuint64());
}
```
Tokens:
Raw