UsualUSDC | Ethereum

codeslaw

UsualUSDCSolidityv0.8.26+commit.8a97fa7a

network

Ethereum

address0xec4cb55f378ecb9ce24b497ef6c78a68f67e2468

deployer0x61f69366EBA5a9Be0d98d5f25cb747d865C1E923

tx last 12 months

0 txs

calls last 12 months

6.2k calls

27 Files

lib

openzeppelin-contracts

contracts

access

IAccessControl.sol

extensions

IAccessControlDefaultAdminRules.sol

interfaces

IERC5267.sol

draft-IERC6093.sol

token

ERC20

IERC20.sol

extensions

IERC20Metadata.sol

IERC20Permit.sol

utils

Panic.sol

Strings.sol

cryptography

ECDSA.sol

MessageHashUtils.sol

math

Math.sol

SafeCast.sol

SignedMath.sol

openzeppelin-contracts-upgradeable

contracts

proxy

utils

Initializable.sol

token

ERC20

ERC20Upgradeable.sol

extensions

ERC20PausableUpgradeable.sol

ERC20PermitUpgradeable.sol

utils

ContextUpgradeable.sol

NoncesUpgradeable.sol

PausableUpgradeable.sol

cryptography

EIP712Upgradeable.sol

src

constants.sol

usual

UsualUSDC.sol

interfaces

IRegistryAccess.sol

IUsdc.sol

IUsualUSDC.sol

Source: Etherscan, Smart Contract Sanctuary, or Sourcify. For more information, see our about page.

abi

constructor

constructor()

functions

allowance

view

function allowance(address owner, address spender) view returns (uint256)

balanceOf

view

function balanceOf(address account) view returns (uint256)

decimals

pure

function decimals() pure returns (uint8)

DOMAIN_SEPARATOR

view

function DOMAIN_SEPARATOR() view returns (bytes32)

eip712Domain

view

function eip712Domain() view returns (bytes1 fields, string name, string version, uint256 chainId, address verifyingContract, bytes32 salt, uint256[] extensions)

feeRecipient

view

function feeRecipient() view returns (address)

getWrappableAmount

view

function getWrappableAmount(uint256 amount) view returns (uint256)

isBlacklisted

view

function isBlacklisted(address account) view returns (bool)

isRedemptionAllowListed

view

function isRedemptionAllowListed(address account) view returns (bool)

mintCap

view

function mintCap() view returns (uint256)

name

view

function name() view returns (string)

nonces

view

function nonces(address owner) view returns (uint256)

paused

view

function paused() view returns (bool)

redemptionFeeBps

view

function redemptionFeeBps() view returns (uint256)

registryAccess

view

function registryAccess() view returns (address)

symbol

view

function symbol() view returns (string)

totalSupply

view

function totalSupply() view returns (uint256)

usdc

view

function usdc() view returns (address)

UsualUSDCStorageV0Location

view

function UsualUSDCStorageV0Location() view returns (bytes32)

addToRedemptionAllowList

nonpayable

function addToRedemptionAllowList(address account)

approve

nonpayable

function approve(address spender, uint256 value) returns (bool)

blacklist

nonpayable

function blacklist(address account)

initialize

nonpayable

function initialize(address usdc_, address registryAccess_, address feeRecipient_)

pause

nonpayable

function pause()

permit

nonpayable

function permit(address owner, address spender, uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s)

removeFromRedemptionAllowList

nonpayable

function removeFromRedemptionAllowList(address account)

setFeeRecipient

nonpayable

function setFeeRecipient(address newFeeRecipient)

setMintCap

nonpayable

function setMintCap(uint256 newMintCap)

setRedemptionFee

nonpayable

function setRedemptionFee(uint256 newRedemptionFeeBps)

transfer

nonpayable

function transfer(address to, uint256 value) returns (bool)

transferFrom

nonpayable

function transferFrom(address from, address to, uint256 value) returns (bool)

unBlacklist

nonpayable

function unBlacklist(address account)

unpause

nonpayable

function unpause()

unwrap

nonpayable

function unwrap(address recipient, uint256 amount) returns (uint256)

wrap

nonpayable

function wrap(address recipient, uint256 amount) returns (uint256)

wrapWithPermit

nonpayable

function wrapWithPermit(address recipient, uint256 amount, uint256 deadline, uint8 v, bytes32 r, bytes32 s) returns (uint256)

events

Approval

event Approval(address indexed owner, address indexed spender, uint256 value)

Blacklist

event Blacklist(address indexed account)

EIP712DomainChanged

event EIP712DomainChanged()

FeeCollected

event FeeCollected(address indexed account, uint256 amount, uint256 fee, address indexed feeRecipient)

FeeRecipientSet

event FeeRecipientSet(address indexed newFeeRecipient)

Initialized

event Initialized(uint64 version)

MintCapSet

event MintCapSet(uint256 newMintCap)

Paused

event Paused(address account)

RedemptionAllowListed

event RedemptionAllowListed(address indexed account)

RedemptionFeeSet

event RedemptionFeeSet(uint256 newRedemptionFeeBps)

RedemptionUnAllowListed

event RedemptionUnAllowListed(address indexed account)

Transfer

event Transfer(address indexed from, address indexed to, uint256 value)

UnBlacklist

event UnBlacklist(address indexed account)

Unpaused

event Unpaused(address account)

Unwrap

event Unwrap(address indexed account, uint256 amount, uint256 fee)

Wrap

event Wrap(address indexed account, uint256 amount)

errors

Blacklisted

error Blacklisted()

ECDSAInvalidSignature

error ECDSAInvalidSignature()

ECDSAInvalidSignatureLength

error ECDSAInvalidSignatureLength(uint256 length)

ECDSAInvalidSignatureS

error ECDSAInvalidSignatureS(bytes32 s)

EnforcedPause

error EnforcedPause()

ERC20InsufficientAllowance

error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed)

ERC20InsufficientBalance

error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed)

ERC20InvalidApprover

error ERC20InvalidApprover(address approver)

ERC20InvalidReceiver

error ERC20InvalidReceiver(address receiver)

ERC20InvalidSender

error ERC20InvalidSender(address sender)

ERC20InvalidSpender

error ERC20InvalidSpender(address spender)

ERC2612ExpiredSignature

error ERC2612ExpiredSignature(uint256 deadline)

ERC2612InvalidSigner

error ERC2612InvalidSigner(address signer, address owner)

ExpectedPause

error ExpectedPause()

InvalidAccountNonce

error InvalidAccountNonce(address account, uint256 currentNonce)

InvalidAmount

error InvalidAmount()

InvalidInitialization

error InvalidInitialization()

InvalidRedemptionFee

error InvalidRedemptionFee()

MintCapExceeded

error MintCapExceeded()

NotAuthorized

error NotAuthorized()

NotInitializing

error NotInitializing()

NullAddress

error NullAddress()

SameValue

error SameValue()

ZeroFeeRecipient

error ZeroFeeRecipient()

ZeroRegistryAccess

error ZeroRegistryAccess()

ZeroUsdc

error ZeroUsdc()

bytecode

creation bytecode

0x6080604052348015600e575f80fd5b5060156019565b60c9565b7ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a00805468010000000000000000900460ff161560685760405163f92ee8a960e01b815260040160405180910390fd5b80546001600160401b039081161460c65780546001600160401b0319166001600160401b0390811782556040519081527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b50565b613db8806100d65f395ff3fe608060405234801561000f575f80fd5b506004361061024f575f3560e01c80636e0896aa1161013d578063a9059cbb116100b8578063d68002f311610088578063e74b981b1161006e578063e74b981b14610660578063f9f92be414610673578063fe575a8714610686575f80fd5b8063d68002f3146105d5578063dd62ed3e146105fc575f80fd5b8063a9059cbb14610589578063bf376c7a1461059c578063c0c53b8b146105af578063d505accf146105c2575f80fd5b80637ecebe001161010d57806384b0196e116100f357806384b0196e1461055357806395d89b411461056e5780639f52884614610576575f80fd5b80637ecebe00146105385780638456cb591461054b575f80fd5b80636e0896aa146104d857806370a08231146104eb57806376c71ca1146104fe5780637dbc1df014610525575f80fd5b80633644e515116101cd5780634070a0c91161019d5780634d37f1be116101835780634d37f1be1461044a578063501012a1146104715780635c975abb146104ae575f80fd5b80634070a0c9146103fa578063469048401461040d575f80fd5b80633644e5151461037957806339f47693146103815780633e413bee146103945780633f4ba83a146103f2575f80fd5b80631a8952661161022257806323b872dd1161020857806323b872dd146103005780632b54626314610313578063313ce5671461036a575f80fd5b80631a895266146102da5780631b9d7e19146102ed575f80fd5b806304030ec41461025357806306fdde0314610268578063095ea7b31461028657806318160ddd146102a9575b5f80fd5b6102666102613660046137ad565b6106dd565b005b610270610911565b60405161027d9190613812565b60405180910390f35b610299610294366004613824565b6109c9565b604051901515815260200161027d565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace02545b60405190815260200161027d565b6102666102e83660046137ad565b6109e2565b6102666102fb3660046137ad565b610c16565b61029961030e36600461384c565b610e4e565b6102996103213660046137ad565b73ffffffffffffffffffffffffffffffffffffffff165f9081527f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123306602052604090205460ff1690565b6040516006815260200161027d565b6102cc610e73565b6102cc61038f366004613824565b610e81565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde1233025473ffffffffffffffffffffffffffffffffffffffff165b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200161027d565b610266610fa5565b610266610408366004613886565b6110c1565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde1233045473ffffffffffffffffffffffffffffffffffffffff166103cd565b6102cc7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330081565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde1233035473ffffffffffffffffffffffffffffffffffffffff166103cd565b7fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f033005460ff16610299565b6102cc6104e6366004613886565b611247565b6102cc6104f93660046137ad565b6112d3565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123300546102cc565b610266610533366004613886565b611323565b6102cc6105463660046137ad565b611500565b61026661150a565b61055b611623565b60405161027d979695949392919061389d565b610270611722565b6102cc61058436600461396c565b611773565b610299610597366004613824565b6118dc565b6102cc6105aa366004613824565b6118e9565b6102666105bd3660046139c0565b61199c565b6102666105d0366004613a00565b611da8565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123301546102cc565b6102cc61060a366004613a66565b73ffffffffffffffffffffffffffffffffffffffff9182165f9081527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace016020908152604080832093909416825291909152205490565b61026661066e3660046137ad565b611f70565b6102666106813660046137ad565b612196565b6102996106943660046137ad565b73ffffffffffffffffffffffffffffffffffffffff165f9081527f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123305602052604090205460ff1690565b73ffffffffffffffffffffffffffffffffffffffff811661072a576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f42340f606b9206eca665f886d4239f03157dd3e547df56ce6aa90946a99e663a600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa1580156107e1573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906108059190613a97565b61083b576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f90815260068201602052604090205460ff1661089b576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f81815260068301602052604080822080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00169055517f78077407b0027e0ffc064076711acad14bb9ab534fb7d3a6a93717cf77b111eb9190a25050565b60605f7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace005b905080600301805461094790613ab6565b80601f016020809104026020016040519081016040528092919081815260200182805461097390613ab6565b80156109be5780601f10610995576101008083540402835291602001916109be565b820191905f5260205f20905b8154815290600101906020018083116109a157829003601f168201915b505050505091505090565b5f336109d68185856123ce565b60019150505b92915050565b73ffffffffffffffffffffffffffffffffffffffff8116610a2f576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f22435ed027edf5f902dc0093fbc24cdb50c05b5fd5f311b78c67c1cbaff60e13600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa158015610ae6573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610b0a9190613a97565b610b40576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f90815260058201602052604090205460ff16610ba0576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f81815260058301602052604080822080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00169055517fc653d95790bb2472667b557ef27642a37cac57b69d6d5fddcaacef8f62589dcb9190a25050565b73ffffffffffffffffffffffffffffffffffffffff8116610c63576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f42340f606b9206eca665f886d4239f03157dd3e547df56ce6aa90946a99e663a600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa158015610d1a573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190610d3e9190613a97565b610d74576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f90815260068201602052604090205460ff1615610dd5576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f81815260068301602052604080822080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00166001179055517fab97a3eea50bf17bcc3480b4dd86d5bd614b3091333a672ac6875b2e4f4552a99190a25050565b5f33610e5b8582856123e0565b610e668585856124cd565b60019150505b9392505050565b5f610e7c612576565b905090565b5f815f03610ebb576040517f2c5211c600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b335f9081527f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330660205260409020547f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde1233009060ff16610f44576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8416610f91576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b610f9d8133868661257f565b949350505050565b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f89b8cb65438d51f53be67ee6029747fbffc20cdedaf07e8998787a67315c91dc600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa15801561105c573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906110809190613a97565b6110b6576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6110be6127d4565b50565b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f5ba406ee14bb34db8b3dbbf677c9ad0c51ae0ccc3fffb1801328e9e22888b578600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa158015611178573d5f803e3d5ffd5b505050506040513d601f19601f8201168201806040525081019061119c9190613a97565b6111d2576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8054820361120c576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b8181556040518281527fcda03296b648d791f2cee5a5af4b32860d8a3d01fae4126b12b4081224003767906020015b60405180910390a15050565b5f806112717f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace025490565b90505f61129c7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde1233005490565b90508082106112ae57505f9392505050565b5f6112b98383613b34565b90508085106112c857806112ca565b845b95945050505050565b5f807f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace005b73ffffffffffffffffffffffffffffffffffffffff9093165f9081526020939093525050604090205490565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123301547f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330090820361139f576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6127108211156113db576040517fc9a06bc800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b60038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f42340f606b9206eca665f886d4239f03157dd3e547df56ce6aa90946a99e663a600482015233602482015273ffffffffffffffffffffffffffffffffffffffff909116906391d1485490604401602060405180830381865afa15801561146f573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906114939190613a97565b6114c9576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600181018290556040518281527f91cc643d187eb250905520d3dae0b1017edd16961d27ab9a4a61fea5e38f717d9060200161123b565b5f6109dc82612871565b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f95b87017abc3e0b2bcc2363291cd5355c5ee91b5bbecfc81df85ce6dd4b0a750600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa1580156115c1573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906115e59190613a97565b61161b576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6110be612899565b5f60608082808083817fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100805490915015801561166157506001810154155b6116cc576040517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601560248201527f4549503731323a20556e696e697469616c697a6564000000000000000000000060448201526064015b60405180910390fd5b6116d4612912565b6116dc612963565b604080515f808252602082019092527f0f000000000000000000000000000000000000000000000000000000000000009c939b5091995046985030975095509350915050565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0480546060917f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace009161094790613ab6565b5f855f036117ad576040517f2c5211c600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff87166117fa576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060028101546040517fd505accf000000000000000000000000000000000000000000000000000000008152336004820152306024820152604481018a90526064810189905260ff8816608482015260a4810187905260c4810186905291925073ffffffffffffffffffffffffffffffffffffffff169063d505accf9060e4015f604051808303815f87803b1580156118b2575f80fd5b505af19250505080156118c3575060015b506118d081338a8a61298c565b98975050505050505050565b5f336109d68185856124cd565b5f815f03611923576040517f2c5211c600000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8316611970576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b610e6c7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330033858561298c565b5f6119a5612a91565b805490915060ff68010000000000000000820416159067ffffffffffffffff165f811580156119d15750825b90505f8267ffffffffffffffff1660011480156119ed5750303b155b9050811580156119fb575080155b15611a32576040517ff92ee8a900000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b84547fffffffffffffffffffffffffffffffffffffffffffffffff00000000000000001660011785558315611a935784547fffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff16680100000000000000001785555b73ffffffffffffffffffffffffffffffffffffffff8816611ae0576040517fe14a4c2700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8716611b2d576040517f3c43d34100000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8616611b7a576040517fcff9f19400000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b611bee6040518060400160405280600981526020017f557375616c5553444300000000000000000000000000000000000000000000008152506040518060400160405280600981526020017f555355414c555344430000000000000000000000000000000000000000000000815250612ab9565b611bf6612acf565b611c346040518060400160405280600981526020017f557375616c555344430000000000000000000000000000000000000000000000815250612ad9565b7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123302805473ffffffffffffffffffffffffffffffffffffffff8a81167fffffffffffffffffffffffff0000000000000000000000000000000000000000928316179092557f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330380548a84169083161790557f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde123304805492891692909116821790556040517f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330091907fbf9a9534339a9d6b81696e05dcfb614b7dc518a31d48be3cfb757988381fb323905f90a2508315611d9e5784547fffffffffffffffffffffffffffffffffffffffffffffff00ffffffffffffffff168555604051600181527fc7f505b2f371ae2175ee4913f4499e1f2633a7b5936321eed1cdaeb6115181d29060200160405180910390a15b5050505050505050565b83421115611de5576040517f62791302000000000000000000000000000000000000000000000000000000008152600481018590526024016116c3565b5f7f6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9888888611e5c8c73ffffffffffffffffffffffffffffffffffffffff165f9081527f5ab42ced628888259c08ac98db1eb0cf702fc1501344311d8b100cd1bfe4bb006020526040902080546001810190915590565b60408051602081019690965273ffffffffffffffffffffffffffffffffffffffff94851690860152929091166060840152608083015260a082015260c0810186905260e0016040516020818303038152906040528051906020012090505f611ec382612b20565b90505f611ed282878787612b67565b90508973ffffffffffffffffffffffffffffffffffffffff168173ffffffffffffffffffffffffffffffffffffffff1614611f59576040517f4b800e4600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff80831660048301528b1660248201526044016116c3565b611f648a8a8a6123ce565b50505050505050505050565b73ffffffffffffffffffffffffffffffffffffffff8116611fbd576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f18f8f4cdd9e29e5f6a4298835010d9f4c69fcafc24b6b78d34d72f89ae8cfa93600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa158015612074573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906120989190613a97565b6120ce576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600481015473ffffffffffffffffffffffffffffffffffffffff90811690831603612125576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6004810180547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff84169081179091556040517fbf9a9534339a9d6b81696e05dcfb614b7dc518a31d48be3cfb757988381fb323905f90a25050565b73ffffffffffffffffffffffffffffffffffffffff81166121e3576040517fe99d5ac500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b5f7f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330060038101546040517f91d148540000000000000000000000000000000000000000000000000000000081527f22435ed027edf5f902dc0093fbc24cdb50c05b5fd5f311b78c67c1cbaff60e13600482015233602482015291925073ffffffffffffffffffffffffffffffffffffffff16906391d1485490604401602060405180830381865afa15801561229a573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906122be9190613a97565b6122f4576040517fea8e4eb500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f90815260058201602052604090205460ff1615612355576040517fc23f6ccb00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff82165f81815260058301602052604080822080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00166001179055517f7811ed4e4b787e4f0f046ffb4a5ec1e064b0eb6d191ffabb66270ed8be89b3259190a25050565b6123db8383836001612b93565b505050565b73ffffffffffffffffffffffffffffffffffffffff8381165f9081527f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0160209081526040808320938616835292905220547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff8110156124c757818110156124b9576040517ffb8f41b200000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8416600482015260248101829052604481018390526064016116c3565b6124c784848484035f612b93565b50505050565b73ffffffffffffffffffffffffffffffffffffffff831661251c576040517f96c6fd1e0000000000000000000000000000000000000000000000000000000081525f60048201526024016116c3565b73ffffffffffffffffffffffffffffffffffffffff821661256b576040517fec442f050000000000000000000000000000000000000000000000000000000081525f60048201526024016116c3565b6123db838383612cfd565b5f610e7c612e66565b60028401545f9073ffffffffffffffffffffffffffffffffffffffff166125a68584612ed9565b5f6125ba8488600101546127106001612f33565b90505f6125c78286613b34565b604080518781526020810185905291925073ffffffffffffffffffffffffffffffffffffffff8916917fe8e8d3915b94f03b4f3342716334ae94bd6f36775da7b263c908889b93d0574b910160405180910390a26040517fa9059cbb00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff87811660048301526024820183905284169063a9059cbb906044016020604051808303815f875af115801561268d573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906126b19190613a97565b5081156127c9576004888101546040517fa9059cbb00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff918216928101839052602481018590529085169063a9059cbb906044016020604051808303815f875af1158015612732573d5f803e3d5ffd5b505050506040513d601f19601f820116820180604052508101906127569190613a97565b508073ffffffffffffffffffffffffffffffffffffffff168873ffffffffffffffffffffffffffffffffffffffff167faeab27ba09d30de467bfd73f90892966b189bb4907d912fe10bbc48b563a17bf88866040516127bf929190918252602082015260400190565b60405180910390a3505b979650505050505050565b6127dc612f75565b7fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f0330080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff001681557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b60405173ffffffffffffffffffffffffffffffffffffffff909116815260200160405180910390a150565b5f807f5ab42ced628888259c08ac98db1eb0cf702fc1501344311d8b100cd1bfe4bb006112f7565b6128a1612fd0565b7fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f0330080547fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff001660011781557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a25833612846565b7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d10280546060917fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d1009161094790613ab6565b60605f7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100610936565b60028401546040517f23b872dd00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8581166004830152306024830152604482018490525f9216906323b872dd906064016020604051808303815f875af1158015612a0a573d5f803e3d5ffd5b505050506040513d601f19601f82011682018060405250810190612a2e9190613a97565b50612a39838361302c565b8373ffffffffffffffffffffffffffffffffffffffff167fb61d00fdfee32467c7d81db64c811ae60c104c346debf36a14afe84b8fce59e583604051612a8191815260200190565b60405180910390a2509392505050565b5f807ff0c57e16840df040f15088dc2f81fe391c3923bec73e23a9662efc9c229c6a006109dc565b612ac1613086565b612acb82826130c4565b5050565b612ad7613086565b565b612ae1613086565b6110be816040518060400160405280600181526020017f3100000000000000000000000000000000000000000000000000000000000000815250613127565b5f6109dc612b2c612576565b836040517f19010000000000000000000000000000000000000000000000000000000000008152600281019290925260228201526042902090565b5f805f80612b7788888888613199565b925092509250612b87828261328c565b50909695505050505050565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0073ffffffffffffffffffffffffffffffffffffffff8516612c03576040517fe602df050000000000000000000000000000000000000000000000000000000081525f60048201526024016116c3565b73ffffffffffffffffffffffffffffffffffffffff8416612c52576040517f94280d620000000000000000000000000000000000000000000000000000000081525f60048201526024016116c3565b73ffffffffffffffffffffffffffffffffffffffff8086165f90815260018301602090815260408083209388168352929052208390558115612cf6578373ffffffffffffffffffffffffffffffffffffffff168573ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b92585604051612ced91815260200190565b60405180910390a35b5050505050565b73ffffffffffffffffffffffffffffffffffffffff83165f9081527f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde12330560205260409020547f6c1ea0a8b31e7a2fd4d4bedab31d832d1a713c4853a122615f24b85bde1233009060ff1680612d97575073ffffffffffffffffffffffffffffffffffffffff83165f90815260058201602052604090205460ff165b15612dce576040517f09550c7700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff8416158015612e245750805482612e187f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace025490565b612e229190613b74565b115b15612e5b576040517f63f10f7700000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6124c784848461338f565b5f7f8b73c3c69bb8fe3d512ecc4cf759cc79239f7b179b0ffacaa9a75d522b39400f612e906133a2565b612e9861341d565b60408051602081019490945283019190915260608201524660808201523060a082015260c00160405160208183030381529060405280519060200120905090565b73ffffffffffffffffffffffffffffffffffffffff8216612f28576040517f96c6fd1e0000000000000000000000000000000000000000000000000000000081525f60048201526024016116c3565b612acb825f83612cfd565b5f612f60612f4083613472565b8015612f5b57505f8480612f5657612f56613b87565b868809115b151590565b612f6b86868661349e565b6112ca9190613b74565b7fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f033005460ff16612ad7576040517f8dfc202b00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b7fcd5ed15c6e187e77e9aee88184c21f4f2182ab5827cb3b7e07fbedcd63f033005460ff1615612ad7576040517fd93c066500000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b73ffffffffffffffffffffffffffffffffffffffff821661307b576040517fec442f050000000000000000000000000000000000000000000000000000000081525f60048201526024016116c3565b612acb5f8383612cfd565b61308e61354e565b612ad7576040517fd7e6bcf800000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b6130cc613086565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace007f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace036131188482613bf8565b50600481016124c78382613bf8565b61312f613086565b7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d1007fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d10261317b8482613bf8565b506003810161318a8382613bf8565b505f8082556001909101555050565b5f80807f7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a08411156131d257505f91506003905082613282565b604080515f808252602082018084528a905260ff891692820192909252606081018790526080810186905260019060a0016020604051602081039080840390855afa158015613223573d5f803e3d5ffd5b50506040517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0015191505073ffffffffffffffffffffffffffffffffffffffff811661327957505f925060019150829050613282565b92505f91508190505b9450945094915050565b5f82600381111561329f5761329f613d0f565b036132a8575050565b60018260038111156132bc576132bc613d0f565b036132f3576040517ff645eedf00000000000000000000000000000000000000000000000000000000815260040160405180910390fd5b600282600381111561330757613307613d0f565b03613341576040517ffce698f7000000000000000000000000000000000000000000000000000000008152600481018290526024016116c3565b600382600381111561335557613355613d0f565b03612acb576040517fd78bce0c000000000000000000000000000000000000000000000000000000008152600481018290526024016116c3565b613397612fd0565b6123db83838361356c565b5f7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d100816133cd612912565b8051909150156133e557805160209091012092915050565b815480156133f4579392505050565b7fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470935050505090565b5f7fa16a46d94261c7517cc8ff89f61c0ce93598e3c849801011dee649a6a557d10081613448612963565b80519091501561346057805160209091012092915050565b600182015480156133f4579392505050565b5f600282600381111561348757613487613d0f565b6134919190613d3c565b60ff166001149050919050565b5f805f6134ab8686613739565b91509150815f036134cf578381816134c5576134c5613b87565b0492505050610e6c565b8184116134e6576134e66003851502601118613774565b5f848688095f868103871696879004966002600389028118808a02820302808a02820302808a02820302808a02820302808a02820302808a02909103029181900381900460010185841190960395909502919093039390930492909217029150509392505050565b5f613557612a91565b5468010000000000000000900460ff16919050565b7f52c63247e1f47db19d5ce0460030c497f067ca4cebf71ba98eeadabe20bace0073ffffffffffffffffffffffffffffffffffffffff84166135c65781816002015f8282546135bb9190613b74565b909155506136769050565b73ffffffffffffffffffffffffffffffffffffffff84165f908152602082905260409020548281101561364b576040517fe450d38c00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8616600482015260248101829052604481018490526064016116c3565b73ffffffffffffffffffffffffffffffffffffffff85165f9081526020839052604090209083900390555b73ffffffffffffffffffffffffffffffffffffffff83166136a15760028101805483900390556136cc565b73ffffffffffffffffffffffffffffffffffffffff83165f9081526020829052604090208054830190555b8273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef8460405161372b91815260200190565b60405180910390a350505050565b5f807fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff83850993909202808410938190039390930393915050565b634e487b715f52806020526024601cfd5b803573ffffffffffffffffffffffffffffffffffffffff811681146137a8575f80fd5b919050565b5f602082840312156137bd575f80fd5b610e6c82613785565b5f81518084528060208401602086015e5f6020828601015260207fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0601f83011685010191505092915050565b602081525f610e6c60208301846137c6565b5f8060408385031215613835575f80fd5b61383e83613785565b946020939093013593505050565b5f805f6060848603121561385e575f80fd5b61386784613785565b925061387560208501613785565b929592945050506040919091013590565b5f60208284031215613896575f80fd5b5035919050565b7fff000000000000000000000000000000000000000000000000000000000000008816815260e060208201525f6138d760e08301896137c6565b82810360408401526138e981896137c6565b6060840188905273ffffffffffffffffffffffffffffffffffffffff8716608085015260a0840186905283810360c0850152845180825260208087019350909101905f5b8181101561394b57835183526020938401939092019160010161392d565b50909b9a5050505050505050505050565b803560ff811681146137a8575f80fd5b5f805f805f8060c08789031215613981575f80fd5b61398a87613785565b955060208701359450604087013593506139a66060880161395c565b9598949750929560808101359460a0909101359350915050565b5f805f606084860312156139d2575f80fd5b6139db84613785565b92506139e960208501613785565b91506139f760408501613785565b90509250925092565b5f805f805f805f60e0888a031215613a16575f80fd5b613a1f88613785565b9650613a2d60208901613785565b95506040880135945060608801359350613a496080890161395c565b9699959850939692959460a0840135945060c09093013592915050565b5f8060408385031215613a77575f80fd5b613a8083613785565b9150613a8e60208401613785565b90509250929050565b5f60208284031215613aa7575f80fd5b81518015158114610e6c575f80fd5b600181811c90821680613aca57607f821691505b602082108103613b01577f4e487b71000000000000000000000000000000000000000000000000000000005f52602260045260245ffd5b50919050565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601160045260245ffd5b818103818111156109dc576109dc613b07565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52604160045260245ffd5b808201808211156109dc576109dc613b07565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b601f8211156123db57805f5260205f20601f840160051c81016020851015613bd95750805b601f840160051c820191505b81811015612cf6575f8155600101613be5565b815167ffffffffffffffff811115613c1257613c12613b47565b613c2681613c208454613ab6565b84613bb4565b6020601f821160018114613c77575f8315613c415750848201515b7fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600385901b1c1916600184901b178455612cf6565b5f848152602081207fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe08516915b82811015613cc45787850151825560209485019460019092019101613ca4565b5084821015613d0057868401517fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600387901b60f8161c191681555b50505050600190811b01905550565b7f4e487b71000000000000000000000000000000000000000000000000000000005f52602160045260245ffd5b5f60ff831680613d73577f4e487b71000000000000000000000000000000000000000000000000000000005f52601260045260245ffd5b8060ff8416069150509291505056fea2646970667358221220e2708f33e8caefab30cca385f5dfedca538e9e37eef504ae9f702715d11bd44664736f6c634300081a0033