Address Contract Verified
Address
0x659E96AB48d403D249e4B28B99B508F1E3c5d43a
Balance
0 ETH
Nonce
1
Code Size
23524 bytes
Creator
0x29891460...5942 at tx 0x79f2d0ec...aff0e3
Indexed Transactions
0
Contract Bytecode
23524 bytes
0x6080604052600436106103c65760003560e01c80637193ec17116101f2578063aa6f29df1161010d578063d547741f116100a0578063ef600be21161006f578063ef600be214610b38578063f141b52b14610b4e578063f9892d1414610b6e578063fc0c546a14610b8457600080fd5b8063d547741f14610ac2578063de0d542114610ae2578063e5b5cf9f14610af8578063e6894a9f14610b1857600080fd5b8063c356c880116100dc578063c356c88014610a42578063ca15c87314610a62578063ca43aa0f14610a82578063d499bb3514610aa257600080fd5b8063aa6f29df146109b0578063aadee89c146109c6578063addd5099146109f6578063bf95c57a14610a2c57600080fd5b80638a874966116101855780639522c9a1116101545780639522c9a114610948578063a217fddf14610968578063a78253731461097d578063aa3637791461099d57600080fd5b80638a874966146108df5780639010d07c146108f2578063918c2f801461091257806391d148541461092857600080fd5b80637ff9b596116101c15780637ff9b5961461087457806383d998ae1461088a5780638456cb59146108aa57806388a8d602146108bf57600080fd5b80637193ec17146107f45780637ad3def2146108145780637e8af985146108345780637fbb4ead1461085457600080fd5b8063248a9ca3116102e25780634b94f50e116102755780635ded9321116102445780635ded93211461076f57806361f8b1021461078457806368ee5e7f146107a45780636fb60d7c146107c457600080fd5b80634b94f50e146106f55780634c790bea1461070a5780634e9f55b6146107375780635c975abb1461075757600080fd5b806336568abe116102b157806336568abe1461068057806338d52e0f146106a05780633f4ba83a146106c05780634031b91c146106d557600080fd5b8063248a9ca3146105fa5780632b899c741461062a5780632f2ff15d1461064a57806330745c0c1461066a57600080fd5b806318ad59491161035a5780631e46e4d3116103295780631e46e4d3146105605780631ec83156146105825780631ee61004146105a257806322725866146105c257600080fd5b806318ad5949146104d95780631930840f146104ee5780631acf08091461050e5780631b2df8501461053e57600080fd5b80630823f628116103965780630823f62814610458578063091dbbd71461046e5780630e46c73b1461048457806316345f18146104a457600080fd5b8062465331146103d257806301c11d96146103e957806301ffc9a71461041257806303cfbc1d1461044257600080fd5b366103cd57005b600080fd5b3480156103de57600080fd5b506103e7610ba4565b005b3480156103f557600080fd5b506103ff60001981565b6040519081526020015b60405180910390f35b34801561041e57600080fd5b5061043261042d366004615237565b610da2565b6040519015158152602001610409565b34801561044e57600080fd5b506103ff60065481565b34801561046457600080fd5b506103ff600b5481565b34801561047a57600080fd5b506103ff60035481565b34801561049057600080fd5b506103e761049f366004615284565b610dcd565b3480156104b057600080fd5b506104c46104bf3660046152bd565b610e39565b60408051928352602083019190915201610409565b3480156104e557600080fd5b506103e7610f8f565b3480156104fa57600080fd5b506103e76105093660046152da565b611079565b34801561051a57600080fd5b506104326105293660046152bd565b60136020526000908152604090205460ff1681565b34801561054a57600080fd5b506103ff600080516020615b6f83398151915281565b34801561056c57600080fd5b506103ff600080516020615b8f83398151915281565b34801561058e57600080fd5b506103e761059d3660046152bd565b61108a565b3480156105ae57600080fd5b506103e76105bd3660046152f3565b611171565b3480156105ce57600080fd5b506012546105e2906001600160a01b031681565b6040516001600160a01b039091168152602001610409565b34801561060657600080fd5b506103ff6106153660046152da565b60009081526020819052604090206001015490565b34801561063657600080fd5b506103e76106453660046152bd565b611258565b34801561065657600080fd5b506103e76106653660046152f3565b61133f565b34801561067657600080fd5b506103ff60085481565b34801561068c57600080fd5b506103e761069b3660046152f3565b611369565b3480156106ac57600080fd5b50600e546105e2906001600160a01b031681565b3480156106cc57600080fd5b506103e76113e7565b3480156106e157600080fd5b506103e76106f0366004615318565b6113fd565b34801561070157600080fd5b506103ff611c7c565b34801561071657600080fd5b506103ff6107253660046152bd565b60156020526000908152604090205481565b34801561074357600080fd5b506103ff610752366004615368565b611cec565b34801561076357600080fd5b5060025460ff16610432565b34801561077b57600080fd5b506103e7611e45565b34801561079057600080fd5b506103e761079f3660046153e3565b611fc9565b3480156107b057600080fd5b506103e76107bf366004615284565b6122f0565b3480156107d057600080fd5b506104326107df3660046152bd565b60146020526000908152604090205460ff1681565b34801561080057600080fd5b506103e761080f3660046152bd565b612353565b34801561082057600080fd5b506103e761082f3660046152bd565b6123fd565b34801561084057600080fd5b5061043261084f366004615405565b6124a7565b34801561086057600080fd5b506103ff61086f3660046152bd565b612540565b34801561088057600080fd5b506103ff60045481565b34801561089657600080fd5b506103e76108a5366004615431565b6125e9565b3480156108b657600080fd5b506103e7612654565b3480156108cb57600080fd5b506010546105e2906001600160a01b031681565b6103e76108ed36600461545f565b612667565b3480156108fe57600080fd5b506105e261090d3660046153e3565b612e23565b34801561091e57600080fd5b506103ff600a5481565b34801561093457600080fd5b506104326109433660046152f3565b612e42565b34801561095457600080fd5b506011546105e2906001600160a01b031681565b34801561097457600080fd5b506103ff600081565b34801561098957600080fd5b506103ff610998366004615405565b612e6b565b6103ff6109ab3660046154c1565b612f2d565b3480156109bc57600080fd5b506103ff600c5481565b3480156109d257600080fd5b506104326109e13660046152bd565b60176020526000908152604090205460ff1681565b348015610a0257600080fd5b506105e2610a113660046152bd565b6016602052600090815260409020546001600160a01b031681565b348015610a3857600080fd5b506103ff600d5481565b348015610a4e57600080fd5b506103ff610a5d366004615368565b6130a2565b348015610a6e57600080fd5b506103ff610a7d3660046152da565b61319e565b348015610a8e57600080fd5b506103e7610a9d3660046153e3565b6131b5565b348015610aae57600080fd5b506103e7610abd366004615284565b61349b565b348015610ace57600080fd5b506103e7610add3660046152f3565b6134fe565b348015610aee57600080fd5b506103ff60095481565b348015610b0457600080fd5b506103e7610b133660046152da565b613523565b348015610b2457600080fd5b506103e7610b333660046152da565b613534565b348015610b4457600080fd5b506103ff60075481565b348015610b5a57600080fd5b506103e7610b693660046152bd565b6135cb565b348015610b7a57600080fd5b506103ff60055481565b348015610b9057600080fd5b50600f546105e2906001600160a01b031681565b600080516020615b6f833981519152610bbc816136b2565b60105460408051633ffcdacb60e11b815281516000936001600160a01b031692637ff9b59692600480820193918290030181865afa158015610c02573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610c2691906154e6565b5090506000601060009054906101000a90046001600160a01b03166001600160a01b0316630ffbfda46040518163ffffffff1660e01b8152600401602060405180830381865afa158015610c7e573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ca2919061550a565b90506000601060009054906101000a90046001600160a01b03166001600160a01b03166361d027b36040518163ffffffff1660e01b8152600401602060405180830381865afa158015610cf9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610d1d9190615523565b600554600f54919250600091610d41918691869086906001600160a01b03166136bc565b600591909155600a819055600c80549192508291600090610d63908490615556565b90915550506040518181527f639642858af2d06e1d3106ffc36d4d73dc180bbaec73fe01cedc2279adc823789060200160405180910390a15050505050565b60006001600160e01b03198216635a05180f60e01b1480610dc75750610dc7826137ca565b92915050565b6000610dd8816136b2565b6001600160a01b038316600081815260136020908152604091829020805460ff191686151590811790915591519182527fffd380df0bbed63123ade804a590609cad3a87260edc296d675b934e2ea3989791015b60405180910390a2505050565b6001600160a01b03808216600090815260166020526040808220548151633fabe5a360e21b815291519293849391169182918491839163feaf968c9160048082019260a0929091908290030181865afa158015610e9a573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610ebe9190615588565b50505091505060008113610f195760405162461bcd60e51b815260206004820152601c60248201527f45766572792e66696e616e63653a20696e76616c69642070726963650000000060448201526064015b60405180910390fd5b6000826001600160a01b031663313ce5676040518163ffffffff1660e01b8152600401602060405180830381865afa158015610f59573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190610f7d91906155d8565b919760ff909216965090945050505050565b600080516020615b6f833981519152610fa7816136b2565b60105460408051633ffcdacb60e11b815281516001600160a01b0390931692637ff9b596926004808401939192918290030181865afa158015610fee573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061101291906154e6565b50600455600380546001919060009061102c908490615556565b90915550506004546003546040517f20deb00abfd29deed79d7a40793215ec3322696fd55a7607817e80c3a4d53bf19261106e92908252602082015260400190565b60405180910390a150565b6000611084816136b2565b50600555565b6000611095816136b2565b6001600160a01b0382166110bb5760405162461bcd60e51b8152600401610f10906155fb565b6011546001600160a01b03908116908316036110e95760405162461bcd60e51b8152600401610f1090615632565b60115461110e90600080516020615b8f833981519152906001600160a01b03166137ff565b611126600080516020615b8f83398151915283613821565b601180546001600160a01b0319166001600160a01b0384169081179091556040517f1f10b725b5854f09baa72682fe48152b3b94338262ec13320232801e2e0e272990600090a25050565b611179613843565b600080516020615b6f833981519152611191816136b2565b826000036111b15760405162461bcd60e51b8152600401610f1090615669565b60105460408051633e50aa6360e21b815290516000926001600160a01b03169163f942a98c9160048083019260209291908290030181865afa1580156111fb573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061121f9190615523565b90506001600160a01b0381166112475760405162461bcd60e51b8152600401610f10906155fb565b61125281858561388b565b50505050565b6000611263816136b2565b6001600160a01b0382166112895760405162461bcd60e51b8152600401610f10906155fb565b6012546001600160a01b03908116908316036112b75760405162461bcd60e51b8152600401610f1090615632565b6012546112dc90600080516020615b8f833981519152906001600160a01b03166137ff565b6112f4600080516020615b8f83398151915283613821565b601280546001600160a01b0319166001600160a01b0384169081179091556040517fea9c68fbed6bb17e0f934d3d83ebe392fa62c908462e66078e470af3e1e3450690600090a25050565b60008281526020819052604090206001015461135a816136b2565b6113648383613821565b505050565b6001600160a01b03811633146113d95760405162461bcd60e51b815260206004820152602f60248201527f416363657373436f6e74726f6c3a2063616e206f6e6c792072656e6f756e636560448201526e103937b632b9903337b91039b2b63360891b6064820152608401610f10565b6113e382826137ff565b5050565b60006113f2816136b2565b6113fa61397c565b50565b611405613843565b836000036114255760405162461bcd60e51b8152600401610f1090615669565b6001600160a01b03851660009081526014602052604090205460ff1661148d5760405162461bcd60e51b815260206004820181905260248201527f45766572792e66696e616e63653a206e6f7420616c6c6f7765642061737365746044820152606401610f10565b600f5460009085906001600160a01b03166370a08231336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa1580156114e8573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061150c919061550a565b101561152a5760405162461bcd60e51b8152600401610f10906156a0565b3360009081526017602052604090205460ff166117f457600f546000906001600160a01b0316634fd6a94a336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602401602060405180830381865afa15801561159a573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906115be919061550a565b9050601060009054906101000a90046001600160a01b03166001600160a01b0316639588254a6040518163ffffffff1660e01b8152600401602060405180830381865afa158015611613573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061163791906156e5565b1561170b57601060009054906101000a90046001600160a01b03166001600160a01b0316638fb84f226040518163ffffffff1660e01b8152600401602060405180830381865afa15801561168f573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906116b3919061550a565b6116bd8242615702565b101561170b5760405162461bcd60e51b815260206004820152601f60248201527f45766572792e46696e616e63653a206d696e206c6f6b757020706572696f64006044820152606401610f10565b601054604051633560925b60e21b8152600481018390526305f5e1009188916001600160a01b039091169063d582496c90602401602060405180830381865afa15801561175c573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611780919061550a565b61178a9190615715565b6117949190615742565b9150828211156117e65760405162461bcd60e51b815260206004820152601e60248201527f45766572792e66696e616e63653a206d617820616c6c6f7765642066656500006044820152606401610f10565b6117f08287615702565b9550505b82841115801561180357508215155b61184f5760405162461bcd60e51b815260206004820152601b60248201527f45766572792e66696e616e63653a2077726f6e672070726963657300000000006044820152606401610f10565b866000036118e55760016008600082825461186a9190615556565b90915550506012546008546003546040516344d8bd6760e01b81526001600160a01b03909316926344d8bd67926118ae9233928c92918c918c918c91600401615764565b600060405180830381600087803b1580156118c857600080fd5b505af11580156118dc573d6000803e3d6000fd5b50505050611aab565b336012546040516331a9108f60e11b8152600481018a90526001600160a01b039283169290911690636352211e90602401602060405180830381865afa158015611933573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119579190615523565b6001600160a01b03161461197d5760405162461bcd60e51b8152600401610f10906157a2565b601254604051631e32954d60e11b8152600481018990526000916001600160a01b031690633c652a9a9060240160c060405180830381865afa1580156119c7573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906119eb91906157e4565b95505050505050806001600160a01b0316876001600160a01b031614611a235760405162461bcd60e51b8152600401610f1090615839565b601254600354604051632bd076ef60e21b8152600481018b905260248101899052604481018890526064810187905260848101919091526001600160a01b0389811660a48301529091169063af41dbbc9060c401600060405180830381600087803b158015611a9157600080fd5b505af1158015611aa5573d6000803e3d6000fd5b50505050505b600f546001600160a01b03166323b872dd336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152306024820152604481018890526064016020604051808303816000875af1158015611b10573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611b3491906156e5565b508015611c3e57600f546001600160a01b03166323b872dd33601060009054906101000a90046001600160a01b03166001600160a01b03166361d027b36040518163ffffffff1660e01b8152600401602060405180830381865afa158015611ba0573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611bc49190615523565b6040516001600160e01b031960e085901b1681526001600160a01b03928316600482015291166024820152604481018490526064016020604051808303816000875af1158015611c18573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611c3c91906156e5565b505b60405185815233907f9345a8a944c0bca27038313dd8066210a495ba6374e523065a2e7adcc020ff2b9060200160405180910390a250505050505050565b60105460408051633ffcdacb60e11b815281516000936001600160a01b031692637ff9b59692600480820193918290030181865afa158015611cc2573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ce691906154e6565b50919050565b6000611cf6613843565b600080516020615b6f833981519152611d0e816136b2565b600454600003611d605760405162461bcd60e51b815260206004820152601f60248201527f45766572792e66696e616e63653a207a65726f20746f6b656e207072696365006044820152606401610f10565b600f54604080516318160ddd60e01b815290516000926001600160a01b0316916318160ddd9160048083019260209291908290030181865afa158015611daa573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611dce919061550a565b9050600080611dde8888886139ce565b91509150818603945080600014611e2b57611df98184615556565b600454611e069083615715565b600554611e139086615715565b611e1d9190615556565b611e279190615742565b6005555b600654600003611e3a57426006555b505050509392505050565b600080516020615b6f833981519152611e5d816136b2565b601054604080516348d2a1db60e11b815290516000926001600160a01b0316916391a543b69160048083019260209291908290030181865afa158015611ea7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611ecb919061550a565b90506000601060009054906101000a90046001600160a01b03166001600160a01b03166361d027b36040518163ffffffff1660e01b8152600401602060405180830381865afa158015611f22573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190611f469190615523565b600654600f54919250600091611f699190859085906001600160a01b0316613ee8565b600691909155600b819055600d80549192508291600090611f8b908490615556565b90915550506040518181527fdc1dc3e62a1ab88d5a5d63ce14f16b489336157e1dbd65ae8253c670b09816999060200160405180910390a150505050565b611fd1613843565b601060009054906101000a90046001600160a01b03166001600160a01b031663896cf64a6040518163ffffffff1660e01b8152600401602060405180830381865afa158015612024573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061204891906156e5565b6120a05760405162461bcd60e51b815260206004820152602360248201527f45766572792e66696e616e63653a206e6f207769746864726177616c2063616e60448201526218d95b60ea1b6064820152608401610f10565b806000036120c05760405162461bcd60e51b8152600401610f1090615669565b336012546040516331a9108f60e11b8152600481018590526001600160a01b039283169290911690636352211e90602401602060405180830381865afa15801561210e573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906121329190615523565b6001600160a01b0316146121585760405162461bcd60e51b8152600401610f10906157a2565b601254604051631e32954d60e11b8152600481018490526000916001600160a01b031690633c652a9a9060240160c060405180830381865afa1580156121a2573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906121c691906157e4565b60125460035460405163ded1e6ff60e01b81529298506001600160a01b03909116965063ded1e6ff95506122069450899350889250908790600401615883565b600060405180830381600087803b15801561222057600080fd5b505af1158015612234573d6000803e3d6000fd5b5050600f546001600160a01b0316915063a9059cbb9050336040516001600160e01b031960e084901b1681526001600160a01b039091166004820152602481018590526044016020604051808303816000875af1158015612299573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906122bd91906156e5565b5060405182815233907f9daf09fdaf1824ce05b79a1127fd3f72439d47a7eaa956c5e51d0da51f0ae0b590602001610e2c565b60006122fb816136b2565b6001600160a01b038316600081815260146020908152604091829020805460ff191686151590811790915591519182527fc98c284776fcb837e44b920e970f47786820c9b65d7e1379aa74e6b5f34072679101610e2c565b600061235e816136b2565b6001600160a01b0382166123845760405162461bcd60e51b8152600401610f10906155fb565b6010546001600160a01b03908116908316036123b25760405162461bcd60e51b8152600401610f1090615632565b601080546001600160a01b0319166001600160a01b0384169081179091556040517fff54978127edd34aec0f9061fb3b155fbe0ededdfa881ee3e0d541d3a1eef43890600090a25050565b6000612408816136b2565b6001600160a01b03821661242e5760405162461bcd60e51b8152600401610f10906155fb565b600f546001600160a01b039081169083160361245c5760405162461bcd60e51b8152600401610f1090615632565b600f80546001600160a01b0319166001600160a01b0384169081179091556040517fc94c224579611362c1287bb3e82a13fbd4a04dd97c05e9fc3acf9a8c62194adb90600090a25050565b6000806000846001600160a01b0316633c652a9a856040518263ffffffff1660e01b81526004016124da91815260200190565b60c060405180830381865afa1580156124f7573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061251b91906157e4565b5050935093505050600454821115801561253757506004548110155b95945050505050565b60105460408051633228036560e11b815290516000926001600160a01b03169163645006ca9160048083019260209291908290030181865afa15801561258a573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906125ae919061550a565b90506000806125bc84610e39565b9092509050816125cd82600a61598b565b6125d79085615715565b6125e19190615742565b949350505050565b60006125f4816136b2565b6001600160a01b0383811660008181526016602090815260409182902080546001600160a01b0319169487169485179055905192835290917fb1d1442dba579887e297ac433e5716c847abf2dc052ee9de4869b7b1b8f6206d9101610e2c565b600061265f816136b2565b6113fa613ff8565b61266f613843565b6000846000036126915760405162461bcd60e51b8152600401610f1090615669565b6001600160a01b03871660009081526013602052604090205460ff166126f95760405162461bcd60e51b815260206004820181905260248201527f45766572792e66696e616e63653a206e6f7420616c6c6f7765642061737365746044820152606401610f10565b61270287612540565b8510156127605760405162461bcd60e51b815260206004820152602660248201527f45766572792e66696e616e63653a206d696e206465706f73697450726f6f6620604482015265105b5bdd5b9d60d21b6064820152608401610f10565b6001600160a01b03871660009081526015602090815260408083205433845260179092529091205460ff166127f8576127998887612e6b565b9150828211156127eb5760405162461bcd60e51b815260206004820152601e60248201527f45766572792e66696e616e63653a206d617820616c6c6f7765642066656500006044820152606401610f10565b6127f58287615702565b95505b601054604051634c55daf560e11b81526001600160a01b038a81166004830152909116906398abb5ea90602401602060405180830381865afa158015612842573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612866919061550a565b6128708783615556565b11156128be5760405162461bcd60e51b815260206004820152601860248201527f45766572792e66696e616e63653a2063617020617373657400000000000000006044820152606401610f10565b8385111580156128cd57508315155b6129195760405162461bcd60e51b815260206004820152601b60248201527f45766572792e66696e616e63653a2077726f6e672070726963657300000000006044820152606401610f10565b6129238682615556565b6001600160a01b0389166000908152601560205260408120919091558790036129d4576001600760008282546129599190615556565b90915550506011546007546003546040516344d8bd6760e01b81526001600160a01b03909316926344d8bd679261299d928e928e92918d918d918d91600401615764565b600060405180830381600087803b1580156129b757600080fd5b505af11580156129cb573d6000803e3d6000fd5b50505050612cc4565b6011546040516331a9108f60e11b8152600481018990526001600160a01b038b8116921690636352211e90602401602060405180830381865afa158015612a1f573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612a439190615523565b6001600160a01b031614612aa55760405162461bcd60e51b815260206004820152602360248201527f45766572792e66696e616e63653a206163636f756e74206973206e6f74206f776044820152623732b960e91b6064820152608401610f10565b601154604051631e32954d60e11b8152600481018990526000916001600160a01b031690633c652a9a9060240160c060405180830381865afa158015612aef573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612b1391906157e4565b95505050505050806001600160a01b0316896001600160a01b031614612b4b5760405162461bcd60e51b8152600401610f1090615839565b6001600160a01b038a163314612c3c57601154604051631e32954d60e11b8152600481018a905260009182916001600160a01b0390911690633c652a9a9060240160c060405180830381865afa158015612ba9573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612bcd91906157e4565b50509350935050508188148015612be357508087145b612c395760405162461bcd60e51b815260206004820152602160248201527f45766572792e66696e616e63653a2070726963657320646f6e2774206d6174636044820152600d60fb1b6064820152608401610f10565b50505b601154600354604051632bd076ef60e21b8152600481018b9052602481018a9052604481018990526064810188905260848101919091526001600160a01b038b811660a48301529091169063af41dbbc9060c401600060405180830381600087803b158015612caa57600080fd5b505af1158015612cbe573d6000803e3d6000fd5b50505050505b6001600160a01b03881615612ced57612ce83330612ce2858a615556565b8b614035565b612d4f565b612cf78287615556565b3414612d4f5760405162461bcd60e51b815260206004820152602160248201527f45766572792e66696e616e63653a206e6f20726571756972656420616d6f756e6044820152601d60fa1b6064820152608401610f10565b8115612dcb57601054604080516361d027b360e01b81529051612dcb926001600160a01b0316916361d027b39160048083019260209291908290030181865afa158015612da0573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612dc49190615523565b838a61388b565b876001600160a01b0316896001600160a01b03167f4ed1a8a57a37b79833de68b3bc01307fc91c77341a669fc487f7e588f986d5ff88604051612e1091815260200190565b60405180910390a3505050505050505050565b6000828152600160205260408120612e3b90836140dd565b9392505050565b6000918252602082815260408084206001600160a01b0393909316845291905290205460ff1690565b6000806000612e7985610e39565b9092509050612e8981600a61598b565b612e938386615715565b612e9d9190615742565b601054604051639fbe42e360e01b8152600481018390529195506001600160a01b031690639fbe42e390602401602060405180830381865afa158015612ee7573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612f0b919061550a565b925081612f1982600a61598b565b612f239085615715565b6125379190615742565b6000600080516020615b6f833981519152612f47816136b2565b60105460408051633ffcdacb60e11b815281516000936001600160a01b031692637ff9b59692600480820193918290030181865afa158015612f8d573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190612fb191906154e6565b5090506000601060009054906101000a90046001600160a01b03166001600160a01b03166361d027b36040518163ffffffff1660e01b8152600401602060405180830381865afa158015613009573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061302d9190615523565b600f54600e549192506130549188918591899186916001600160a01b0391821691166140e9565b6040805188815287151560208201529081018290529094507f7bae0aa453e62cf5912a8ccdca080daabd6a991571676bd27be7d5cefbb9e7e09060600160405180910390a150505092915050565b60006130ac613843565b600080516020615b6f8339815191526130c4816136b2565b6004546000036131165760405162461bcd60e51b815260206004820152601f60248201527f45766572792e66696e616e63653a207a65726f20746f6b656e207072696365006044820152606401610f10565b60006131238686866141be565b80850393509050801561319557600f54604051632770a7eb60e21b8152306004820152602481018390526001600160a01b0390911690639dc29fac90604401600060405180830381600087803b15801561317c57600080fd5b505af1158015613190573d6000803e3d6000fd5b505050505b50509392505050565b6000818152600160205260408120610dc790614625565b6131bd613843565b601060009054906101000a90046001600160a01b03166001600160a01b031663d8d134096040518163ffffffff1660e01b8152600401602060405180830381865afa158015613210573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061323491906156e5565b6132805760405162461bcd60e51b815260206004820181905260248201527f45766572792e66696e616e63653a206e6f206465706f7369742063616e63656c6044820152606401610f10565b806000036132a05760405162461bcd60e51b8152600401610f1090615669565b336011546040516331a9108f60e11b8152600481018590526001600160a01b039283169290911690636352211e90602401602060405180830381865afa1580156132ee573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133129190615523565b6001600160a01b0316146133385760405162461bcd60e51b8152600401610f10906157a2565b601154604051631e32954d60e11b8152600481018490526000916001600160a01b031690633c652a9a9060240160c060405180830381865afa158015613382573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906133a691906157e4565b6001600160a01b03811660009081526015602052604081208054929850899750955093506133d79250859150615702565b909155505060115460035460405163ded1e6ff60e01b81526001600160a01b039092169163ded1e6ff9161341391879187918790600401615883565b600060405180830381600087803b15801561342d57600080fd5b505af1158015613441573d6000803e3d6000fd5b5050505061345661344f3390565b838361388b565b6040518281526001600160a01b0382169033907f570c41ddcccd45610324bf54954d2c598237a089c640ef316f587be12bcdb6099060200160405180910390a3505050565b60006134a6816136b2565b6001600160a01b038316600081815260176020908152604091829020805460ff191686151590811790915591519182527f2caff43bb90426659b5bef885afe0de4a57677ba906af7d0a21e06ee836bafba9101610e2c565b600082815260208190526040902060010154613519816136b2565b61136483836137ff565b600061352e816136b2565b50600655565b600061353f816136b2565b8160000361358f5760405162461bcd60e51b815260206004820152601960248201527f45766572792e66696e616e63653a207a65726f2076616c7565000000000000006044820152606401610f10565b60098290556040518281527f5e50dafbba7602b02e2be3fe44dd0eff01e1cc4839f305ed444efe28e7e740209060200160405180910390a15050565b60006135d6816136b2565b600e546001600160a01b03908116908316036136045760405162461bcd60e51b8152600401610f1090615632565b6001600160a01b038216156136675760008061361f8461462f565b91509150816136405760405162461bcd60e51b8152600401610f1090615997565b601260ff821611156136645760405162461bcd60e51b8152600401610f10906159ce565b50505b600e80546001600160a01b0319166001600160a01b0384169081179091556040517fd1b7a0c4ecac6f46b6536771218edf193a71df1be4de6051064e9e084d8c336790600090a25050565b6113fa813361470b565b6000808281878911156137bd576000888a039050899850613755836001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015613714573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613738919061550a565b6137428a84615715565b6137506305f5e1008e615715565b614764565b6040516340c10f1960e01b81526001600160a01b03898116600483015260248201839052919350908416906340c10f1990604401600060405180830381600087803b1580156137a357600080fd5b505af11580156137b7573d6000803e3d6000fd5b50505050505b9698969750505050505050565b60006001600160e01b03198216637965db0b60e01b1480610dc757506301ffc9a760e01b6001600160e01b0319831614610dc7565b613809828261484d565b600082815260016020526040902061136490826148b2565b61382b82826148c7565b6000828152600160205260409020611364908261494b565b60025460ff16156138895760405162461bcd60e51b815260206004820152601060248201526f14185d5cd8589b194e881c185d5cd95960821b6044820152606401610f10565b565b6001600160a01b03811615613926576000806138a68361462f565b91509150816138c75760405162461bcd60e51b8152600401610f1090615997565b6138d2816012615a05565b90506138df81600a615a1e565b6138e99085615742565b93508360000361390b5760405162461bcd60e51b8152600401610f1090615669565b61391f6001600160a01b0384168686614960565b5050505050565b814710156139465760405162461bcd60e51b8152600401610f10906156a0565b6040516001600160a01b0384169083156108fc029084906000818181858888f19350505050158015611252573d6000803e3d6000fd5b6139846149c3565b6002805460ff191690557f5db9ee0a495bf2e6ff9c91a7834c1ba4fdd244a5e8aa4e537bd38aeae4b073aa335b6040516001600160a01b03909116815260200160405180910390a1565b60008080808080878180828103613a275760405162461bcd60e51b815260206004820152601b60248201527f45766572792e66696e616e63653a2073697a65206973207a65726f00000000006044820152606401610f10565b600954831115613a735760405162461bcd60e51b815260206004820152601760248201527645766572792e66696e616e63653a206d61782073697a6560481b6044820152606401610f10565b60005b83811015613ed8576011546001600160a01b0316636352211e8e8e84818110613aa157613aa1615a2d565b905060200201356040518263ffffffff1660e01b8152600401613ac691815260200190565b602060405180830381865afa158015613ae3573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613b079190615523565b92506001600160a01b038316613b2f5760405162461bcd60e51b8152600401610f10906155fb565b601154613b5d906001600160a01b03168e8e84818110613b5157613b51615a2d565b905060200201356124a7565b613beb576011546001600160a01b031663434838938e8e84818110613b8457613b84615a2d565b905060200201356003546040518363ffffffff1660e01b8152600401613bb4929190918252602082015260400190565b600060405180830381600087803b158015613bce57600080fd5b505af1158015613be2573d6000803e3d6000fd5b50505050613ed0565b898b1115613ed8576011546001600160a01b0316638a3b9e248e8e84818110613c1657613c16615a2d565b905060200201356003546040518363ffffffff1660e01b8152600401613c46929190918252602082015260400190565b600060405180830381600087803b158015613c6057600080fd5b505af1158015613c74573d6000803e3d6000fd5b50506011546001600160a01b03169150633c652a9a90508e8e84818110613c9d57613c9d615a2d565b905060200201356040518263ffffffff1660e01b8152600401613cc291815260200190565b60c060405180830381865afa158015613cdf573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613d0391906157e4565b949c50939550613d199350859250610e39915050565b9096509450613d2e888761375088600a61598b565b9750613d43613d3d8b8d615702565b89614a0c565b9750878a019950613d5f88670de0b6b3a7640000600454614764565b96508615613ddc57600f546040516340c10f1960e01b81526001600160a01b038581166004830152602482018a9052909116906340c10f1990604401600060405180830381600087803b158015613db557600080fd5b505af1158015613dc9573d6000803e3d6000fd5b505050508689613dd99190615556565b98505b613df188613deb87600a61598b565b88614764565b6011549098506001600160a01b0316639072883b8e8e84818110613e1757613e17615a2d565b905060200201358a600354866040518563ffffffff1660e01b8152600401613e429493929190615883565b600060405180830381600087803b158015613e5c57600080fd5b505af1158015613e70573d6000803e3d6000fd5b505050508c8c82818110613e8657613e86615a2d565b905060200201357f6467c916ee98dd5ce57b3b3628fe83512ad14dd6b722fe829d62e2edd15b1a128989604051613ec7929190918252602082015260400190565b60405180910390a25b600101613a76565b5050505050505050935093915050565b600080808615613fee57836000613eff8942615702565b9050613f82826001600160a01b03166318160ddd6040518163ffffffff1660e01b8152600401602060405180830381865afa158015613f42573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190613f66919061550a565b613f70838b615715565b6137506301e133806305f5e100615715565b6040516340c10f1960e01b81526001600160a01b03898116600483015260248201839052429b50919450908316906340c10f1990604401600060405180830381600087803b158015613fd357600080fd5b505af1158015613fe7573d6000803e3d6000fd5b5050505050505b9596945050505050565b614000613843565b6002805460ff191660011790557f62e78cea01bee320cd4e420270b5ea74000d11b0c9f74754ebdbfc544b05a2586139b13390565b6000806140418361462f565b91509150816140625760405162461bcd60e51b8152600401610f1090615997565b601260ff821611156140865760405162461bcd60e51b8152600401610f10906159ce565b60120361409481600a615a1e565b61409e9085615742565b9350836000036140c05760405162461bcd60e51b8152600401610f1090615669565b6140d56001600160a01b038416878787614a22565b505050505050565b6000612e3b8383614a5a565b60008660000361410b5760405162461bcd60e51b8152600401610f1090615669565b60006141178386614a84565b6040516370a0823160e01b81526001600160a01b0387811660048301529192506000918616906370a0823190602401602060405180830381865afa158015614163573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614187919061550a565b905086156141a65761419d89838a898989614b7a565b925050506141b4565b61419d89828a898989614c90565b9695505050505050565b600080808481808080808581036142175760405162461bcd60e51b815260206004820152601b60248201527f45766572792e66696e616e63653a2073697a65206973207a65726f00000000006044820152606401610f10565b6009548611156142635760405162461bcd60e51b815260206004820152601760248201527645766572792e66696e616e63653a206d61782073697a6560481b6044820152606401610f10565b60125460408051631a39d8ef60e01b815290516000926001600160a01b031691631a39d8ef9160048083019260209291908290030181865afa1580156142ad573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906142d1919061550a565b905060005b87811015614614578d8d828181106142f0576142f0615a2d565b6012546040516331a9108f60e11b815260209290920293909301356004820181905299506001600160a01b0390921691636352211e9150602401602060405180830381865afa158015614347573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061436b9190615523565b95506001600160a01b0386166143935760405162461bcd60e51b8152600401610f10906155fb565b6012546143a9906001600160a01b0316886124a7565b61441b57601254600354604051634348389360e01b8152600481018a905260248101919091526001600160a01b0390911690634348389390604401600060405180830381600087803b1580156143fe57600080fd5b505af1158015614412573d6000803e3d6000fd5b5050505061460c565b60125460035460405163228ee78960e21b8152600481018a905260248101919091526001600160a01b0390911690638a3b9e2490604401600060405180830381600087803b15801561446c57600080fd5b505af1158015614480573d6000803e3d6000fd5b5050601254604051631e32954d60e11b8152600481018b90526001600160a01b039091169250633c652a9a915060240160c060405180830381865afa1580156144cd573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906144f191906157e4565b949e50939850614513935061450d92508f91508d905085614764565b8b614a0c565b601254600354604051639072883b60e01b81529d83019d929c506001600160a01b0390911691639072883b91614551918b918f918b90600401615883565b600060405180830381600087803b15801561456b57600080fd5b505af115801561457f573d6000803e3d6000fd5b505050506145988a600454670de0b6b3a7640000614764565b98506145a385610e39565b90945092506145bd896145b785600a61598b565b86614764565b985088156145d0576145d0868a8761388b565b604080518b8152602081018b905288917f5b94ca67c4691571865eb758107ed2a0dd59cb4fcf3a03901aeb35e50ee8c057910160405180910390a25b6001016142d6565b505050505050505050509392505050565b6000610dc7825490565b60408051600481526024810182526020810180516001600160e01b031663313ce56760e01b17905290516000918291829182916001600160a01b0387169161467691615a67565b600060405180830381855afa9150503d80600081146146b1576040519150601f19603f3d011682016040523d82523d6000602084013e6146b6565b606091505b50915091508180156146ca57506020815110155b156146fe576000818060200190518101906146e5919061550a565b905060ff81116146fc576001969095509350505050565b505b5060009485945092505050565b6147158282612e42565b6113e35761472281614d4f565b61472d836020614d61565b60405160200161473e929190615a83565b60408051601f198184030181529082905262461bcd60e51b8252610f1091600401615af8565b600080806000198587098587029250828110838203039150508060000361479e578382816147945761479461572c565b0492505050612e3b565b8084116147e55760405162461bcd60e51b81526020600482015260156024820152744d6174683a206d756c446976206f766572666c6f7760581b6044820152606401610f10565b600084868809600260036001881981018916988990049182028318808302840302808302840302808302840302808302840302808302840302918202909203026000889003889004909101858311909403939093029303949094049190911702949350505050565b6148578282612e42565b156113e3576000828152602081815260408083206001600160a01b0385168085529252808320805460ff1916905551339285917ff6391f5c32d9c69d2a47ea670b442974b53935d1edc7fd64eb21e047a839171b9190a45050565b6000612e3b836001600160a01b038416614efd565b6148d18282612e42565b6113e3576000828152602081815260408083206001600160a01b03851684529091529020805460ff191660011790556149073390565b6001600160a01b0316816001600160a01b0316837f2f8788117e7eff1d82e926ec794901d17c78024a50270940304540a733656f0d60405160405180910390a45050565b6000612e3b836001600160a01b038416614ff0565b6040516001600160a01b03831660248201526044810182905261136490849063a9059cbb60e01b906064015b60408051601f198184030181529190526020810180516001600160e01b03166001600160e01b03199093169290921790915261503f565b60025460ff166138895760405162461bcd60e51b815260206004820152601460248201527314185d5cd8589b194e881b9bdd081c185d5cd95960621b6044820152606401610f10565b6000818310614a1b5781612e3b565b5090919050565b6040516001600160a01b03808516602483015283166044820152606481018290526112529085906323b872dd60e01b9060840161498c565b6000826000018281548110614a7157614a71615a2d565b9060005260206000200154905092915050565b60006001600160a01b038316614aa557506001600160a01b03811631610dc7565b6040516370a0823160e01b81526001600160a01b0383811660048301528416906370a0823190602401602060405180830381865afa158015614aeb573d6000803e3d6000fd5b505050506040513d601f19601f82011682018060405250810190614b0f919061550a565b9050600080614b1d8561462f565b9150915081614b3e5760405162461bcd60e51b8152600401610f1090615997565b601260ff82161115614b625760405162461bcd60e51b8152600401610f10906159ce565b601203614b7081600a615a1e565b6125379084615715565b600080614b878888614a0c565b90508015614c8157604051636fd7d53960e11b8152306004820152602481018290526001600160a01b03848116604483015285919087169063dfafaa7290606401600060405180830381600087803b158015614be257600080fd5b505af1158015614bf6573d6000803e3d6000fd5b505050506000614c0f83670de0b6b3a76400008a614764565b6040516340c10f1960e01b81526001600160a01b03898116600483015260248201839052919250908316906340c10f1990604401600060405180830381600087803b158015614c5d57600080fd5b505af1158015614c71573d6000803e3d6000fd5b50505050828a0393505050614c85565b8791505b509695505050505050565b600080614ca688670de0b6b3a764000088614764565b9050614cb28188614a0c565b905060008115614d415784614cd08389670de0b6b3a7640000614764565b9150614cdd87838761388b565b604051632770a7eb60e21b81526001600160a01b03888116600483015260248201859052821690639dc29fac90604401600060405180830381600087803b158015614d2757600080fd5b505af1158015614d3b573d6000803e3d6000fd5b50505050505b909703979650505050505050565b6060610dc76001600160a01b03831660145b60606000614d70836002615715565b614d7b906002615556565b67ffffffffffffffff811115614d9357614d93615b2b565b6040519080825280601f01601f191660200182016040528015614dbd576020820181803683370190505b509050600360fc1b81600081518110614dd857614dd8615a2d565b60200101906001600160f81b031916908160001a905350600f60fb1b81600181518110614e0757614e07615a2d565b60200101906001600160f81b031916908160001a9053506000614e2b846002615715565b614e36906001615556565b90505b6001811115614eae576f181899199a1a9b1b9c1cb0b131b232b360811b85600f1660108110614e6a57614e6a615a2d565b1a60f81b828281518110614e8057614e80615a2d565b60200101906001600160f81b031916908160001a90535060049490941c93614ea781615b41565b9050614e39565b508315612e3b5760405162461bcd60e51b815260206004820181905260248201527f537472696e67733a20686578206c656e67746820696e73756666696369656e746044820152606401610f10565b60008181526001830160205260408120548015614fe6576000614f21600183615702565b8554909150600090614f3590600190615702565b9050818114614f9a576000866000018281548110614f5557614f55615a2d565b9060005260206000200154905080876000018481548110614f7857614f78615a2d565b6000918252602080832090910192909255918252600188019052604090208390555b8554869080614fab57614fab615b58565b600190038181906000526020600020016000905590558560010160008681526020019081526020016000206000905560019350505050610dc7565b6000915050610dc7565b600081815260018301602052604081205461503757508154600181810184556000848152602080822090930184905584548482528286019093526040902091909155610dc7565b506000610dc7565b6000615094826040518060400160405280602081526020017f5361666545524332303a206c6f772d6c6576656c2063616c6c206661696c6564815250856001600160a01b03166151149092919063ffffffff16565b90508051600014806150b55750808060200190518101906150b591906156e5565b6113645760405162461bcd60e51b815260206004820152602a60248201527f5361666545524332303a204552433230206f7065726174696f6e20646964206e6044820152691bdd081cdd58d8d9595960b21b6064820152608401610f10565b60606125e1848460008585600080866001600160a01b0316858760405161513b9190615a67565b60006040518083038185875af1925050503d8060008114615178576040519150601f19603f3d011682016040523d82523d6000602084013e61517d565b606091505b509150915061518e87838387615199565b979650505050505050565b60608315615208578251600003615201576001600160a01b0385163b6152015760405162461bcd60e51b815260206004820152601d60248201527f416464726573733a2063616c6c20746f206e6f6e2d636f6e74726163740000006044820152606401610f10565b50816125e1565b6125e1838381511561521d5781518083602001fd5b8060405162461bcd60e51b8152600401610f109190615af8565b60006020828403121561524957600080fd5b81356001600160e01b031981168114612e3b57600080fd5b6001600160a01b03811681146113fa57600080fd5b80151581146113fa57600080fd5b6000806040838503121561529757600080fd5b82356152a281615261565b915060208301356152b281615276565b809150509250929050565b6000602082840312156152cf57600080fd5b8135612e3b81615261565b6000602082840312156152ec57600080fd5b5035919050565b6000806040838503121561530657600080fd5b8235915060208301356152b281615261565b60008060008060008060c0878903121561533157600080fd5b86359550602087013561534381615261565b95989597505050506040840135936060810135936080820135935060a0909101359150565b60008060006040848603121561537d57600080fd5b833567ffffffffffffffff8082111561539557600080fd5b818601915086601f8301126153a957600080fd5b8135818111156153b857600080fd5b8760208260051b85010111156153cd57600080fd5b6020928301989097509590910135949350505050565b600080604083850312156153f657600080fd5b50508035926020909101359150565b6000806040838503121561541857600080fd5b823561542381615261565b946020939093013593505050565b6000806040838503121561544457600080fd5b823561544f81615261565b915060208301356152b281615261565b600080600080600080600060e0888a03121561547a57600080fd5b873561548581615261565b9650602088013561549581615261565b96999698505050506040850135946060810135946080820135945060a0820135935060c0909101359150565b600080604083850312156154d457600080fd5b8235915060208301356152b281615276565b600080604083850312156154f957600080fd5b505080516020909101519092909150565b60006020828403121561551c57600080fd5b5051919050565b60006020828403121561553557600080fd5b8151612e3b81615261565b634e487b7160e01b600052601160045260246000fd5b80820180821115610dc757610dc7615540565b805169ffffffffffffffffffff8116811461558357600080fd5b919050565b600080600080600060a086880312156155a057600080fd5b6155a986615569565b94506020860151935060408601519250606086015191506155cc60808701615569565b90509295509295909350565b6000602082840312156155ea57600080fd5b815160ff81168114612e3b57600080fd5b6020808252601b908201527f45766572792e66696e616e63653a207a65726f20616464726573730000000000604082015260600190565b60208082526018908201527f45766572792e66696e616e63653a206e6f206368616e67650000000000000000604082015260600190565b6020808252601a908201527f45766572792e66696e616e63653a207a65726f20616d6f756e74000000000000604082015260600190565b60208082526025908201527f45766572792e66696e616e63653a20616d6f756e7420657863656564732062616040820152646c616e636560d81b606082015260800190565b6000602082840312156156f757600080fd5b8151612e3b81615276565b81810381811115610dc757610dc7615540565b8082028115828204841417610dc757610dc7615540565b634e487b7160e01b600052601260045260246000fd5b60008261575f57634e487b7160e01b600052601260045260246000fd5b500490565b6001600160a01b03978816815295909616602086015260408501939093526060840191909152608083015260a082015260c081019190915260e00190565b60208082526022908201527f45766572792e66696e616e63653a2063616c6c6572206973206e6f74206f776e60408201526132b960f11b606082015260800190565b60008060008060008060c087890312156157fd57600080fd5b865195506020870151945060408701519350606087015192506080870151915060a087015161582b81615261565b809150509295509295509295565b6020808252602a908201527f45766572792e66696e616e63653a206578697374696e6720617373657420697360408201526908191a5999995c995b9d60b21b606082015260800190565b938452602084019290925260408301526001600160a01b0316606082015260800190565b600181815b808511156158e25781600019048211156158c8576158c8615540565b808516156158d557918102915b93841c93908002906158ac565b509250929050565b6000826158f957506001610dc7565b8161590657506000610dc7565b816001811461591c576002811461592657615942565b6001915050610dc7565b60ff84111561593757615937615540565b50506001821b610dc7565b5060208310610133831016604e8410600b8410161715615965575081810a610dc7565b61596f83836158a7565b806000190482111561598357615983615540565b029392505050565b6000612e3b83836158ea565b60208082526019908201527f45766572792e66696e616e63653a206e6f20646563696d616c00000000000000604082015260600190565b6020808252601a908201527f45766572792e66696e616e63653a206d617820646563696d616c000000000000604082015260600190565b60ff8281168282160390811115610dc757610dc7615540565b6000612e3b60ff8416836158ea565b634e487b7160e01b600052603260045260246000fd5b60005b83811015615a5e578181015183820152602001615a46565b50506000910152565b60008251615a79818460208701615a43565b9190910192915050565b7f416363657373436f6e74726f6c3a206163636f756e7420000000000000000000815260008351615abb816017850160208801615a43565b7001034b99036b4b9b9b4b733903937b6329607d1b6017918401918201528351615aec816028840160208801615a43565b01602801949350505050565b6020815260008251806020840152615b17816040850160208701615a43565b601f01601f19169190910160400192915050565b634e487b7160e01b600052604160045260246000fd5b600081615b5057615b50615540565b506000190190565b634e487b7160e01b600052603160045260246000fdfeaf290d8680820aad922855f39b306097b20e28774d6c1ad35a20325630c3a02cdba9d4814de7442473c10d2fdcacfd3889f350ecb0ae366d368a26981d4b4454a2646970667358221220760cd2240c55461d07c8a68ee1503a48d1b44d29813142d49e49db22b0e6c9bf64736f6c63430008140033
Verified Source Code Full Match
Compiler: v0.8.20+commit.a1b79de6
EVM: paris
Optimization: Yes (200 runs)
AggregatorV3Interface.sol 32 lines
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
interface AggregatorV3Interface {
function decimals() external view returns (uint8);
function description() external view returns (string memory);
function version() external view returns (uint256);
function getRoundData(uint80 _roundId)
external
view
returns (
uint80 roundId,
int256 answer,
uint256 startedAt,
uint256 updatedAt,
uint80 answeredInRound
);
function latestRoundData()
external
view
returns (
uint80 roundId,
int256 answer,
uint256 startedAt,
uint256 updatedAt,
uint80 answeredInRound
);
}
AccessControl.sol 248 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/AccessControl.sol)
pragma solidity ^0.8.0;
import "./IAccessControl.sol";
import "../utils/Context.sol";
import "../utils/Strings.sol";
import "../utils/introspection/ERC165.sol";
/**
* @dev Contract module that allows children to implement role-based access
* control mechanisms. This is a lightweight version that doesn't allow enumerating role
* members except through off-chain means by accessing the contract event logs. Some
* applications may benefit from on-chain enumerability, for those cases see
* {AccessControlEnumerable}.
*
* Roles are referred to by their `bytes32` identifier. These should be exposed
* in the external API and be unique. The best way to achieve this is by
* using `public constant` hash digests:
*
* ```solidity
* bytes32 public constant MY_ROLE = keccak256("MY_ROLE");
* ```
*
* Roles can be used to represent a set of permissions. To restrict access to a
* function call, use {hasRole}:
*
* ```solidity
* function foo() public {
* require(hasRole(MY_ROLE, msg.sender));
* ...
* }
* ```
*
* Roles can be granted and revoked dynamically via the {grantRole} and
* {revokeRole} functions. Each role has an associated admin role, and only
* accounts that have a role's admin role can call {grantRole} and {revokeRole}.
*
* By default, the admin role for all roles is `DEFAULT_ADMIN_ROLE`, which means
* that only accounts with this role will be able to grant or revoke other
* roles. More complex role relationships can be created by using
* {_setRoleAdmin}.
*
* WARNING: The `DEFAULT_ADMIN_ROLE` is also its own admin: it has permission to
* grant and revoke this role. Extra precautions should be taken to secure
* accounts that have been granted it. We recommend using {AccessControlDefaultAdminRules}
* to enforce additional security measures for this role.
*/
abstract contract AccessControl is Context, IAccessControl, ERC165 {
struct RoleData {
mapping(address => bool) members;
bytes32 adminRole;
}
mapping(bytes32 => RoleData) private _roles;
bytes32 public constant DEFAULT_ADMIN_ROLE = 0x00;
/**
* @dev Modifier that checks that an account has a specific role. Reverts
* with a standardized message including the required role.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*
* _Available since v4.1._
*/
modifier onlyRole(bytes32 role) {
_checkRole(role);
_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControl).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) public view virtual override returns (bool) {
return _roles[role].members[account];
}
/**
* @dev Revert with a standard message if `_msgSender()` is missing `role`.
* Overriding this function changes the behavior of the {onlyRole} modifier.
*
* Format of the revert message is described in {_checkRole}.
*
* _Available since v4.6._
*/
function _checkRole(bytes32 role) internal view virtual {
_checkRole(role, _msgSender());
}
/**
* @dev Revert with a standard message if `account` is missing `role`.
*
* The format of the revert reason is given by the following regular expression:
*
* /^AccessControl: account (0x[0-9a-f]{40}) is missing role (0x[0-9a-f]{64})$/
*/
function _checkRole(bytes32 role, address account) internal view virtual {
if (!hasRole(role, account)) {
revert(
string(
abi.encodePacked(
"AccessControl: account ",
Strings.toHexString(account),
" is missing role ",
Strings.toHexString(uint256(role), 32)
)
)
);
}
}
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) public view virtual override returns (bytes32) {
return _roles[role].adminRole;
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*
* May emit a {RoleGranted} event.
*/
function grantRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_grantRole(role, account);
}
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*
* May emit a {RoleRevoked} event.
*/
function revokeRole(bytes32 role, address account) public virtual override onlyRole(getRoleAdmin(role)) {
_revokeRole(role, account);
}
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been revoked `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*
* May emit a {RoleRevoked} event.
*/
function renounceRole(bytes32 role, address account) public virtual override {
require(account == _msgSender(), "AccessControl: can only renounce roles for self");
_revokeRole(role, account);
}
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event. Note that unlike {grantRole}, this function doesn't perform any
* checks on the calling account.
*
* May emit a {RoleGranted} event.
*
* [WARNING]
* ====
* This function should only be called from the constructor when setting
* up the initial roles for the system.
*
* Using this function in any other way is effectively circumventing the admin
* system imposed by {AccessControl}.
* ====
*
* NOTE: This function is deprecated in favor of {_grantRole}.
*/
function _setupRole(bytes32 role, address account) internal virtual {
_grantRole(role, account);
}
/**
* @dev Sets `adminRole` as ``role``'s admin role.
*
* Emits a {RoleAdminChanged} event.
*/
function _setRoleAdmin(bytes32 role, bytes32 adminRole) internal virtual {
bytes32 previousAdminRole = getRoleAdmin(role);
_roles[role].adminRole = adminRole;
emit RoleAdminChanged(role, previousAdminRole, adminRole);
}
/**
* @dev Grants `role` to `account`.
*
* Internal function without access restriction.
*
* May emit a {RoleGranted} event.
*/
function _grantRole(bytes32 role, address account) internal virtual {
if (!hasRole(role, account)) {
_roles[role].members[account] = true;
emit RoleGranted(role, account, _msgSender());
}
}
/**
* @dev Revokes `role` from `account`.
*
* Internal function without access restriction.
*
* May emit a {RoleRevoked} event.
*/
function _revokeRole(bytes32 role, address account) internal virtual {
if (hasRole(role, account)) {
_roles[role].members[account] = false;
emit RoleRevoked(role, account, _msgSender());
}
}
}
AccessControlEnumerable.sol 64 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (access/AccessControlEnumerable.sol)
pragma solidity ^0.8.0;
import "./IAccessControlEnumerable.sol";
import "./AccessControl.sol";
import "../utils/structs/EnumerableSet.sol";
/**
* @dev Extension of {AccessControl} that allows enumerating the members of each role.
*/
abstract contract AccessControlEnumerable is IAccessControlEnumerable, AccessControl {
using EnumerableSet for EnumerableSet.AddressSet;
mapping(bytes32 => EnumerableSet.AddressSet) private _roleMembers;
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IAccessControlEnumerable).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev Returns one of the accounts that have `role`. `index` must be a
* value between 0 and {getRoleMemberCount}, non-inclusive.
*
* Role bearers are not sorted in any particular way, and their ordering may
* change at any point.
*
* WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
* you perform all queries on the same block. See the following
* https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
* for more information.
*/
function getRoleMember(bytes32 role, uint256 index) public view virtual override returns (address) {
return _roleMembers[role].at(index);
}
/**
* @dev Returns the number of accounts that have `role`. Can be used
* together with {getRoleMember} to enumerate all bearers of a role.
*/
function getRoleMemberCount(bytes32 role) public view virtual override returns (uint256) {
return _roleMembers[role].length();
}
/**
* @dev Overload {_grantRole} to track enumerable memberships
*/
function _grantRole(bytes32 role, address account) internal virtual override {
super._grantRole(role, account);
_roleMembers[role].add(account);
}
/**
* @dev Overload {_revokeRole} to track enumerable memberships
*/
function _revokeRole(bytes32 role, address account) internal virtual override {
super._revokeRole(role, account);
_roleMembers[role].remove(account);
}
}
IAccessControl.sol 88 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControl.sol)
pragma solidity ^0.8.0;
/**
* @dev External interface of AccessControl declared to support ERC165 detection.
*/
interface IAccessControl {
/**
* @dev Emitted when `newAdminRole` is set as ``role``'s admin role, replacing `previousAdminRole`
*
* `DEFAULT_ADMIN_ROLE` is the starting admin for all roles, despite
* {RoleAdminChanged} not being emitted signaling this.
*
* _Available since v3.1._
*/
event RoleAdminChanged(bytes32 indexed role, bytes32 indexed previousAdminRole, bytes32 indexed newAdminRole);
/**
* @dev Emitted when `account` is granted `role`.
*
* `sender` is the account that originated the contract call, an admin role
* bearer except when using {AccessControl-_setupRole}.
*/
event RoleGranted(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Emitted when `account` is revoked `role`.
*
* `sender` is the account that originated the contract call:
* - if using `revokeRole`, it is the admin role bearer
* - if using `renounceRole`, it is the role bearer (i.e. `account`)
*/
event RoleRevoked(bytes32 indexed role, address indexed account, address indexed sender);
/**
* @dev Returns `true` if `account` has been granted `role`.
*/
function hasRole(bytes32 role, address account) external view returns (bool);
/**
* @dev Returns the admin role that controls `role`. See {grantRole} and
* {revokeRole}.
*
* To change a role's admin, use {AccessControl-_setRoleAdmin}.
*/
function getRoleAdmin(bytes32 role) external view returns (bytes32);
/**
* @dev Grants `role` to `account`.
*
* If `account` had not been already granted `role`, emits a {RoleGranted}
* event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function grantRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from `account`.
*
* If `account` had been granted `role`, emits a {RoleRevoked} event.
*
* Requirements:
*
* - the caller must have ``role``'s admin role.
*/
function revokeRole(bytes32 role, address account) external;
/**
* @dev Revokes `role` from the calling account.
*
* Roles are often managed via {grantRole} and {revokeRole}: this function's
* purpose is to provide a mechanism for accounts to lose their privileges
* if they are compromised (such as when a trusted device is misplaced).
*
* If the calling account had been granted `role`, emits a {RoleRevoked}
* event.
*
* Requirements:
*
* - the caller must be `account`.
*/
function renounceRole(bytes32 role, address account) external;
}
IAccessControlEnumerable.sol 31 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (access/IAccessControlEnumerable.sol)
pragma solidity ^0.8.0;
import "./IAccessControl.sol";
/**
* @dev External interface of AccessControlEnumerable declared to support ERC165 detection.
*/
interface IAccessControlEnumerable is IAccessControl {
/**
* @dev Returns one of the accounts that have `role`. `index` must be a
* value between 0 and {getRoleMemberCount}, non-inclusive.
*
* Role bearers are not sorted in any particular way, and their ordering may
* change at any point.
*
* WARNING: When using {getRoleMember} and {getRoleMemberCount}, make sure
* you perform all queries on the same block. See the following
* https://forum.openzeppelin.com/t/iterating-over-elements-on-enumerableset-in-openzeppelin-contracts/2296[forum post]
* for more information.
*/
function getRoleMember(bytes32 role, uint256 index) external view returns (address);
/**
* @dev Returns the number of accounts that have `role`. Can be used
* together with {getRoleMember} to enumerate all bearers of a role.
*/
function getRoleMemberCount(bytes32 role) external view returns (uint256);
}
Ownable.sol 83 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (access/Ownable.sol)
pragma solidity ^0.8.0;
import "../utils/Context.sol";
/**
* @dev Contract module which provides a basic access control mechanism, where
* there is an account (an owner) that can be granted exclusive access to
* specific functions.
*
* By default, the owner account will be the one that deploys the contract. This
* can later be changed with {transferOwnership}.
*
* This module is used through inheritance. It will make available the modifier
* `onlyOwner`, which can be applied to your functions to restrict their use to
* the owner.
*/
abstract contract Ownable is Context {
address private _owner;
event OwnershipTransferred(address indexed previousOwner, address indexed newOwner);
/**
* @dev Initializes the contract setting the deployer as the initial owner.
*/
constructor() {
_transferOwnership(_msgSender());
}
/**
* @dev Throws if called by any account other than the owner.
*/
modifier onlyOwner() {
_checkOwner();
_;
}
/**
* @dev Returns the address of the current owner.
*/
function owner() public view virtual returns (address) {
return _owner;
}
/**
* @dev Throws if the sender is not the owner.
*/
function _checkOwner() internal view virtual {
require(owner() == _msgSender(), "Ownable: caller is not the owner");
}
/**
* @dev Leaves the contract without owner. It will not be possible to call
* `onlyOwner` functions. Can only be called by the current owner.
*
* NOTE: Renouncing ownership will leave the contract without an owner,
* thereby disabling any functionality that is only available to the owner.
*/
function renounceOwnership() public virtual onlyOwner {
_transferOwnership(address(0));
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Can only be called by the current owner.
*/
function transferOwnership(address newOwner) public virtual onlyOwner {
require(newOwner != address(0), "Ownable: new owner is the zero address");
_transferOwnership(newOwner);
}
/**
* @dev Transfers ownership of the contract to a new account (`newOwner`).
* Internal function without access restriction.
*/
function _transferOwnership(address newOwner) internal virtual {
address oldOwner = _owner;
_owner = newOwner;
emit OwnershipTransferred(oldOwner, newOwner);
}
}
Pausable.sol 105 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.7.0) (security/Pausable.sol)
pragma solidity ^0.8.0;
import "../utils/Context.sol";
/**
* @dev Contract module which allows children to implement an emergency stop
* mechanism that can be triggered by an authorized account.
*
* This module is used through inheritance. It will make available the
* modifiers `whenNotPaused` and `whenPaused`, which can be applied to
* the functions of your contract. Note that they will not be pausable by
* simply including this module, only once the modifiers are put in place.
*/
abstract contract Pausable is Context {
/**
* @dev Emitted when the pause is triggered by `account`.
*/
event Paused(address account);
/**
* @dev Emitted when the pause is lifted by `account`.
*/
event Unpaused(address account);
bool private _paused;
/**
* @dev Initializes the contract in unpaused state.
*/
constructor() {
_paused = false;
}
/**
* @dev Modifier to make a function callable only when the contract is not paused.
*
* Requirements:
*
* - The contract must not be paused.
*/
modifier whenNotPaused() {
_requireNotPaused();
_;
}
/**
* @dev Modifier to make a function callable only when the contract is paused.
*
* Requirements:
*
* - The contract must be paused.
*/
modifier whenPaused() {
_requirePaused();
_;
}
/**
* @dev Returns true if the contract is paused, and false otherwise.
*/
function paused() public view virtual returns (bool) {
return _paused;
}
/**
* @dev Throws if the contract is paused.
*/
function _requireNotPaused() internal view virtual {
require(!paused(), "Pausable: paused");
}
/**
* @dev Throws if the contract is not paused.
*/
function _requirePaused() internal view virtual {
require(paused(), "Pausable: not paused");
}
/**
* @dev Triggers stopped state.
*
* Requirements:
*
* - The contract must not be paused.
*/
function _pause() internal virtual whenNotPaused {
_paused = true;
emit Paused(_msgSender());
}
/**
* @dev Returns to normal state.
*
* Requirements:
*
* - The contract must be paused.
*/
function _unpause() internal virtual whenPaused {
_paused = false;
emit Unpaused(_msgSender());
}
}
ERC20.sol 365 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/ERC20.sol)
pragma solidity ^0.8.0;
import "./IERC20.sol";
import "./extensions/IERC20Metadata.sol";
import "../../utils/Context.sol";
/**
* @dev Implementation of the {IERC20} interface.
*
* This implementation is agnostic to the way tokens are created. This means
* that a supply mechanism has to be added in a derived contract using {_mint}.
* For a generic mechanism see {ERC20PresetMinterPauser}.
*
* TIP: For a detailed writeup see our guide
* https://forum.openzeppelin.com/t/how-to-implement-erc20-supply-mechanisms/226[How
* to implement supply mechanisms].
*
* The default value of {decimals} is 18. To change this, you should override
* this function so it returns a different value.
*
* We have followed general OpenZeppelin Contracts guidelines: functions revert
* instead returning `false` on failure. This behavior is nonetheless
* conventional and does not conflict with the expectations of ERC20
* applications.
*
* Additionally, an {Approval} event is emitted on calls to {transferFrom}.
* This allows applications to reconstruct the allowance for all accounts just
* by listening to said events. Other implementations of the EIP may not emit
* these events, as it isn't required by the specification.
*
* Finally, the non-standard {decreaseAllowance} and {increaseAllowance}
* functions have been added to mitigate the well-known issues around setting
* allowances. See {IERC20-approve}.
*/
contract ERC20 is Context, IERC20, IERC20Metadata {
mapping(address => uint256) private _balances;
mapping(address => mapping(address => uint256)) private _allowances;
uint256 private _totalSupply;
string private _name;
string private _symbol;
/**
* @dev Sets the values for {name} and {symbol}.
*
* All two of these values are immutable: they can only be set once during
* construction.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev Returns the name of the token.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev Returns the symbol of the token, usually a shorter version of the
* name.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev Returns the number of decimals used to get its user representation.
* For example, if `decimals` equals `2`, a balance of `505` tokens should
* be displayed to a user as `5.05` (`505 / 10 ** 2`).
*
* Tokens usually opt for a value of 18, imitating the relationship between
* Ether and Wei. This is the default value returned by this function, unless
* it's overridden.
*
* NOTE: This information is only used for _display_ purposes: it in
* no way affects any of the arithmetic of the contract, including
* {IERC20-balanceOf} and {IERC20-transfer}.
*/
function decimals() public view virtual override returns (uint8) {
return 18;
}
/**
* @dev See {IERC20-totalSupply}.
*/
function totalSupply() public view virtual override returns (uint256) {
return _totalSupply;
}
/**
* @dev See {IERC20-balanceOf}.
*/
function balanceOf(address account) public view virtual override returns (uint256) {
return _balances[account];
}
/**
* @dev See {IERC20-transfer}.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - the caller must have a balance of at least `amount`.
*/
function transfer(address to, uint256 amount) public virtual override returns (bool) {
address owner = _msgSender();
_transfer(owner, to, amount);
return true;
}
/**
* @dev See {IERC20-allowance}.
*/
function allowance(address owner, address spender) public view virtual override returns (uint256) {
return _allowances[owner][spender];
}
/**
* @dev See {IERC20-approve}.
*
* NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
* `transferFrom`. This is semantically equivalent to an infinite approval.
*
* Requirements:
*
* - `spender` cannot be the zero address.
*/
function approve(address spender, uint256 amount) public virtual override returns (bool) {
address owner = _msgSender();
_approve(owner, spender, amount);
return true;
}
/**
* @dev See {IERC20-transferFrom}.
*
* Emits an {Approval} event indicating the updated allowance. This is not
* required by the EIP. See the note at the beginning of {ERC20}.
*
* NOTE: Does not update the allowance if the current allowance
* is the maximum `uint256`.
*
* Requirements:
*
* - `from` and `to` cannot be the zero address.
* - `from` must have a balance of at least `amount`.
* - the caller must have allowance for ``from``'s tokens of at least
* `amount`.
*/
function transferFrom(address from, address to, uint256 amount) public virtual override returns (bool) {
address spender = _msgSender();
_spendAllowance(from, spender, amount);
_transfer(from, to, amount);
return true;
}
/**
* @dev Atomically increases the allowance granted to `spender` by the caller.
*
* This is an alternative to {approve} that can be used as a mitigation for
* problems described in {IERC20-approve}.
*
* Emits an {Approval} event indicating the updated allowance.
*
* Requirements:
*
* - `spender` cannot be the zero address.
*/
function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
address owner = _msgSender();
_approve(owner, spender, allowance(owner, spender) + addedValue);
return true;
}
/**
* @dev Atomically decreases the allowance granted to `spender` by the caller.
*
* This is an alternative to {approve} that can be used as a mitigation for
* problems described in {IERC20-approve}.
*
* Emits an {Approval} event indicating the updated allowance.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `spender` must have allowance for the caller of at least
* `subtractedValue`.
*/
function decreaseAllowance(address spender, uint256 subtractedValue) public virtual returns (bool) {
address owner = _msgSender();
uint256 currentAllowance = allowance(owner, spender);
require(currentAllowance >= subtractedValue, "ERC20: decreased allowance below zero");
unchecked {
_approve(owner, spender, currentAllowance - subtractedValue);
}
return true;
}
/**
* @dev Moves `amount` of tokens from `from` to `to`.
*
* This internal function is equivalent to {transfer}, and can be used to
* e.g. implement automatic token fees, slashing mechanisms, etc.
*
* Emits a {Transfer} event.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `from` must have a balance of at least `amount`.
*/
function _transfer(address from, address to, uint256 amount) internal virtual {
require(from != address(0), "ERC20: transfer from the zero address");
require(to != address(0), "ERC20: transfer to the zero address");
_beforeTokenTransfer(from, to, amount);
uint256 fromBalance = _balances[from];
require(fromBalance >= amount, "ERC20: transfer amount exceeds balance");
unchecked {
_balances[from] = fromBalance - amount;
// Overflow not possible: the sum of all balances is capped by totalSupply, and the sum is preserved by
// decrementing then incrementing.
_balances[to] += amount;
}
emit Transfer(from, to, amount);
_afterTokenTransfer(from, to, amount);
}
/** @dev Creates `amount` tokens and assigns them to `account`, increasing
* the total supply.
*
* Emits a {Transfer} event with `from` set to the zero address.
*
* Requirements:
*
* - `account` cannot be the zero address.
*/
function _mint(address account, uint256 amount) internal virtual {
require(account != address(0), "ERC20: mint to the zero address");
_beforeTokenTransfer(address(0), account, amount);
_totalSupply += amount;
unchecked {
// Overflow not possible: balance + amount is at most totalSupply + amount, which is checked above.
_balances[account] += amount;
}
emit Transfer(address(0), account, amount);
_afterTokenTransfer(address(0), account, amount);
}
/**
* @dev Destroys `amount` tokens from `account`, reducing the
* total supply.
*
* Emits a {Transfer} event with `to` set to the zero address.
*
* Requirements:
*
* - `account` cannot be the zero address.
* - `account` must have at least `amount` tokens.
*/
function _burn(address account, uint256 amount) internal virtual {
require(account != address(0), "ERC20: burn from the zero address");
_beforeTokenTransfer(account, address(0), amount);
uint256 accountBalance = _balances[account];
require(accountBalance >= amount, "ERC20: burn amount exceeds balance");
unchecked {
_balances[account] = accountBalance - amount;
// Overflow not possible: amount <= accountBalance <= totalSupply.
_totalSupply -= amount;
}
emit Transfer(account, address(0), amount);
_afterTokenTransfer(account, address(0), amount);
}
/**
* @dev Sets `amount` as the allowance of `spender` over the `owner` s tokens.
*
* This internal function is equivalent to `approve`, and can be used to
* e.g. set automatic allowances for certain subsystems, etc.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `owner` cannot be the zero address.
* - `spender` cannot be the zero address.
*/
function _approve(address owner, address spender, uint256 amount) internal virtual {
require(owner != address(0), "ERC20: approve from the zero address");
require(spender != address(0), "ERC20: approve to the zero address");
_allowances[owner][spender] = amount;
emit Approval(owner, spender, amount);
}
/**
* @dev Updates `owner` s allowance for `spender` based on spent `amount`.
*
* Does not update the allowance amount in case of infinite allowance.
* Revert if not enough allowance is available.
*
* Might emit an {Approval} event.
*/
function _spendAllowance(address owner, address spender, uint256 amount) internal virtual {
uint256 currentAllowance = allowance(owner, spender);
if (currentAllowance != type(uint256).max) {
require(currentAllowance >= amount, "ERC20: insufficient allowance");
unchecked {
_approve(owner, spender, currentAllowance - amount);
}
}
}
/**
* @dev Hook that is called before any transfer of tokens. This includes
* minting and burning.
*
* Calling conditions:
*
* - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* will be transferred to `to`.
* - when `from` is zero, `amount` tokens will be minted for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(address from, address to, uint256 amount) internal virtual {}
/**
* @dev Hook that is called after any transfer of tokens. This includes
* minting and burning.
*
* Calling conditions:
*
* - when `from` and `to` are both non-zero, `amount` of ``from``'s tokens
* has been transferred to `to`.
* - when `from` is zero, `amount` tokens have been minted for `to`.
* - when `to` is zero, `amount` of ``from``'s tokens have been burned.
* - `from` and `to` are never both zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(address from, address to, uint256 amount) internal virtual {}
}
IERC20Metadata.sol 28 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC20/extensions/IERC20Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
/**
* @dev Interface for the optional metadata functions from the ERC20 standard.
*
* _Available since v4.1._
*/
interface IERC20Metadata is IERC20 {
/**
* @dev Returns the name of the token.
*/
function name() external view returns (string memory);
/**
* @dev Returns the symbol of the token.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the decimals places of the token.
*/
function decimals() external view returns (uint8);
}
IERC20Permit.sol 90 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (token/ERC20/extensions/IERC20Permit.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 Permit extension allowing approvals to be made via signatures, as defined in
* https://eips.ethereum.org/EIPS/eip-2612[EIP-2612].
*
* Adds the {permit} method, which can be used to change an account's ERC20 allowance (see {IERC20-allowance}) by
* presenting a message signed by the account. By not relying on {IERC20-approve}, the token holder account doesn't
* need to send a transaction, and thus is not required to hold Ether at all.
*
* ==== Security Considerations
*
* There are two important considerations concerning the use of `permit`. The first is that a valid permit signature
* expresses an allowance, and it should not be assumed to convey additional meaning. In particular, it should not be
* considered as an intention to spend the allowance in any specific way. The second is that because permits have
* built-in replay protection and can be submitted by anyone, they can be frontrun. A protocol that uses permits should
* take this into consideration and allow a `permit` call to fail. Combining these two aspects, a pattern that may be
* generally recommended is:
*
* ```solidity
* function doThingWithPermit(..., uint256 value, uint256 deadline, uint8 v, bytes32 r, bytes32 s) public {
* try token.permit(msg.sender, address(this), value, deadline, v, r, s) {} catch {}
* doThing(..., value);
* }
*
* function doThing(..., uint256 value) public {
* token.safeTransferFrom(msg.sender, address(this), value);
* ...
* }
* ```
*
* Observe that: 1) `msg.sender` is used as the owner, leaving no ambiguity as to the signer intent, and 2) the use of
* `try/catch` allows the permit to fail and makes the code tolerant to frontrunning. (See also
* {SafeERC20-safeTransferFrom}).
*
* Additionally, note that smart contract wallets (such as Argent or Safe) are not able to produce permit signatures, so
* contracts should have entry points that don't rely on permit.
*/
interface IERC20Permit {
/**
* @dev Sets `value` as the allowance of `spender` over ``owner``'s tokens,
* given ``owner``'s signed approval.
*
* IMPORTANT: The same issues {IERC20-approve} has related to transaction
* ordering also apply here.
*
* Emits an {Approval} event.
*
* Requirements:
*
* - `spender` cannot be the zero address.
* - `deadline` must be a timestamp in the future.
* - `v`, `r` and `s` must be a valid `secp256k1` signature from `owner`
* over the EIP712-formatted function arguments.
* - the signature must use ``owner``'s current nonce (see {nonces}).
*
* For more information on the signature format, see the
* https://eips.ethereum.org/EIPS/eip-2612#specification[relevant EIP
* section].
*
* CAUTION: See Security Considerations above.
*/
function permit(
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) external;
/**
* @dev Returns the current nonce for `owner`. This value must be
* included whenever a signature is generated for {permit}.
*
* Every successful call to {permit} increases ``owner``'s nonce by one. This
* prevents a signature from being used multiple times.
*/
function nonces(address owner) external view returns (uint256);
/**
* @dev Returns the domain separator used in the encoding of the signature for {permit}, as defined by {EIP712}.
*/
// solhint-disable-next-line func-name-mixedcase
function DOMAIN_SEPARATOR() external view returns (bytes32);
}
IERC20.sol 78 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC20/IERC20.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC20 standard as defined in the EIP.
*/
interface IERC20 {
/**
* @dev Emitted when `value` tokens are moved from one account (`from`) to
* another (`to`).
*
* Note that `value` may be zero.
*/
event Transfer(address indexed from, address indexed to, uint256 value);
/**
* @dev Emitted when the allowance of a `spender` for an `owner` is set by
* a call to {approve}. `value` is the new allowance.
*/
event Approval(address indexed owner, address indexed spender, uint256 value);
/**
* @dev Returns the amount of tokens in existence.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns the amount of tokens owned by `account`.
*/
function balanceOf(address account) external view returns (uint256);
/**
* @dev Moves `amount` tokens from the caller's account to `to`.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transfer(address to, uint256 amount) external returns (bool);
/**
* @dev Returns the remaining number of tokens that `spender` will be
* allowed to spend on behalf of `owner` through {transferFrom}. This is
* zero by default.
*
* This value changes when {approve} or {transferFrom} are called.
*/
function allowance(address owner, address spender) external view returns (uint256);
/**
* @dev Sets `amount` as the allowance of `spender` over the caller's tokens.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* IMPORTANT: Beware that changing an allowance with this method brings the risk
* that someone may use both the old and the new allowance by unfortunate
* transaction ordering. One possible solution to mitigate this race
* condition is to first reduce the spender's allowance to 0 and set the
* desired value afterwards:
* https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
*
* Emits an {Approval} event.
*/
function approve(address spender, uint256 amount) external returns (bool);
/**
* @dev Moves `amount` tokens from `from` to `to` using the
* allowance mechanism. `amount` is then deducted from the caller's
* allowance.
*
* Returns a boolean value indicating whether the operation succeeded.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 amount) external returns (bool);
}
SafeERC20.sol 143 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.3) (token/ERC20/utils/SafeERC20.sol)
pragma solidity ^0.8.0;
import "../IERC20.sol";
import "../extensions/IERC20Permit.sol";
import "../../../utils/Address.sol";
/**
* @title SafeERC20
* @dev Wrappers around ERC20 operations that throw on failure (when the token
* contract returns false). Tokens that return no value (and instead revert or
* throw on failure) are also supported, non-reverting calls are assumed to be
* successful.
* To use this library you can add a `using SafeERC20 for IERC20;` statement to your contract,
* which allows you to call the safe operations as `token.safeTransfer(...)`, etc.
*/
library SafeERC20 {
using Address for address;
/**
* @dev Transfer `value` amount of `token` from the calling contract to `to`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeTransfer(IERC20 token, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transfer.selector, to, value));
}
/**
* @dev Transfer `value` amount of `token` from `from` to `to`, spending the approval given by `from` to the
* calling contract. If `token` returns no value, non-reverting calls are assumed to be successful.
*/
function safeTransferFrom(IERC20 token, address from, address to, uint256 value) internal {
_callOptionalReturn(token, abi.encodeWithSelector(token.transferFrom.selector, from, to, value));
}
/**
* @dev Deprecated. This function has issues similar to the ones found in
* {IERC20-approve}, and its usage is discouraged.
*
* Whenever possible, use {safeIncreaseAllowance} and
* {safeDecreaseAllowance} instead.
*/
function safeApprove(IERC20 token, address spender, uint256 value) internal {
// safeApprove should only be called when setting an initial allowance,
// or when resetting it to zero. To increase and decrease it, use
// 'safeIncreaseAllowance' and 'safeDecreaseAllowance'
require(
(value == 0) || (token.allowance(address(this), spender) == 0),
"SafeERC20: approve from non-zero to non-zero allowance"
);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, value));
}
/**
* @dev Increase the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeIncreaseAllowance(IERC20 token, address spender, uint256 value) internal {
uint256 oldAllowance = token.allowance(address(this), spender);
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance + value));
}
/**
* @dev Decrease the calling contract's allowance toward `spender` by `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful.
*/
function safeDecreaseAllowance(IERC20 token, address spender, uint256 value) internal {
unchecked {
uint256 oldAllowance = token.allowance(address(this), spender);
require(oldAllowance >= value, "SafeERC20: decreased allowance below zero");
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, oldAllowance - value));
}
}
/**
* @dev Set the calling contract's allowance toward `spender` to `value`. If `token` returns no value,
* non-reverting calls are assumed to be successful. Meant to be used with tokens that require the approval
* to be set to zero before setting it to a non-zero value, such as USDT.
*/
function forceApprove(IERC20 token, address spender, uint256 value) internal {
bytes memory approvalCall = abi.encodeWithSelector(token.approve.selector, spender, value);
if (!_callOptionalReturnBool(token, approvalCall)) {
_callOptionalReturn(token, abi.encodeWithSelector(token.approve.selector, spender, 0));
_callOptionalReturn(token, approvalCall);
}
}
/**
* @dev Use a ERC-2612 signature to set the `owner` approval toward `spender` on `token`.
* Revert on invalid signature.
*/
function safePermit(
IERC20Permit token,
address owner,
address spender,
uint256 value,
uint256 deadline,
uint8 v,
bytes32 r,
bytes32 s
) internal {
uint256 nonceBefore = token.nonces(owner);
token.permit(owner, spender, value, deadline, v, r, s);
uint256 nonceAfter = token.nonces(owner);
require(nonceAfter == nonceBefore + 1, "SafeERC20: permit did not succeed");
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*/
function _callOptionalReturn(IERC20 token, bytes memory data) private {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We use {Address-functionCall} to perform this call, which verifies that
// the target address contains contract code and also asserts for success in the low-level call.
bytes memory returndata = address(token).functionCall(data, "SafeERC20: low-level call failed");
require(returndata.length == 0 || abi.decode(returndata, (bool)), "SafeERC20: ERC20 operation did not succeed");
}
/**
* @dev Imitates a Solidity high-level call (i.e. a regular function call to a contract), relaxing the requirement
* on the return value: the return value is optional (but if data is returned, it must not be false).
* @param token The token targeted by the call.
* @param data The call data (encoded using abi.encode or one of its variants).
*
* This is a variant of {_callOptionalReturn} that silents catches all reverts and returns a bool instead.
*/
function _callOptionalReturnBool(IERC20 token, bytes memory data) private returns (bool) {
// We need to perform a low level call here, to bypass Solidity's return data size checking mechanism, since
// we're implementing it ourselves. We cannot use {Address-functionCall} here since this should return false
// and not revert is the subcall reverts.
(bool success, bytes memory returndata) = address(token).call(data);
return
success && (returndata.length == 0 || abi.decode(returndata, (bool))) && Address.isContract(address(token));
}
}
ERC721.sol 466 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC721/ERC721.sol)
pragma solidity ^0.8.0;
import "./IERC721.sol";
import "./IERC721Receiver.sol";
import "./extensions/IERC721Metadata.sol";
import "../../utils/Address.sol";
import "../../utils/Context.sol";
import "../../utils/Strings.sol";
import "../../utils/introspection/ERC165.sol";
/**
* @dev Implementation of https://eips.ethereum.org/EIPS/eip-721[ERC721] Non-Fungible Token Standard, including
* the Metadata extension, but not including the Enumerable extension, which is available separately as
* {ERC721Enumerable}.
*/
contract ERC721 is Context, ERC165, IERC721, IERC721Metadata {
using Address for address;
using Strings for uint256;
// Token name
string private _name;
// Token symbol
string private _symbol;
// Mapping from token ID to owner address
mapping(uint256 => address) private _owners;
// Mapping owner address to token count
mapping(address => uint256) private _balances;
// Mapping from token ID to approved address
mapping(uint256 => address) private _tokenApprovals;
// Mapping from owner to operator approvals
mapping(address => mapping(address => bool)) private _operatorApprovals;
/**
* @dev Initializes the contract by setting a `name` and a `symbol` to the token collection.
*/
constructor(string memory name_, string memory symbol_) {
_name = name_;
_symbol = symbol_;
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(ERC165, IERC165) returns (bool) {
return
interfaceId == type(IERC721).interfaceId ||
interfaceId == type(IERC721Metadata).interfaceId ||
super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721-balanceOf}.
*/
function balanceOf(address owner) public view virtual override returns (uint256) {
require(owner != address(0), "ERC721: address zero is not a valid owner");
return _balances[owner];
}
/**
* @dev See {IERC721-ownerOf}.
*/
function ownerOf(uint256 tokenId) public view virtual override returns (address) {
address owner = _ownerOf(tokenId);
require(owner != address(0), "ERC721: invalid token ID");
return owner;
}
/**
* @dev See {IERC721Metadata-name}.
*/
function name() public view virtual override returns (string memory) {
return _name;
}
/**
* @dev See {IERC721Metadata-symbol}.
*/
function symbol() public view virtual override returns (string memory) {
return _symbol;
}
/**
* @dev See {IERC721Metadata-tokenURI}.
*/
function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
_requireMinted(tokenId);
string memory baseURI = _baseURI();
return bytes(baseURI).length > 0 ? string(abi.encodePacked(baseURI, tokenId.toString())) : "";
}
/**
* @dev Base URI for computing {tokenURI}. If set, the resulting URI for each
* token will be the concatenation of the `baseURI` and the `tokenId`. Empty
* by default, can be overridden in child contracts.
*/
function _baseURI() internal view virtual returns (string memory) {
return "";
}
/**
* @dev See {IERC721-approve}.
*/
function approve(address to, uint256 tokenId) public virtual override {
address owner = ERC721.ownerOf(tokenId);
require(to != owner, "ERC721: approval to current owner");
require(
_msgSender() == owner || isApprovedForAll(owner, _msgSender()),
"ERC721: approve caller is not token owner or approved for all"
);
_approve(to, tokenId);
}
/**
* @dev See {IERC721-getApproved}.
*/
function getApproved(uint256 tokenId) public view virtual override returns (address) {
_requireMinted(tokenId);
return _tokenApprovals[tokenId];
}
/**
* @dev See {IERC721-setApprovalForAll}.
*/
function setApprovalForAll(address operator, bool approved) public virtual override {
_setApprovalForAll(_msgSender(), operator, approved);
}
/**
* @dev See {IERC721-isApprovedForAll}.
*/
function isApprovedForAll(address owner, address operator) public view virtual override returns (bool) {
return _operatorApprovals[owner][operator];
}
/**
* @dev See {IERC721-transferFrom}.
*/
function transferFrom(address from, address to, uint256 tokenId) public virtual override {
//solhint-disable-next-line max-line-length
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_transfer(from, to, tokenId);
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) public virtual override {
safeTransferFrom(from, to, tokenId, "");
}
/**
* @dev See {IERC721-safeTransferFrom}.
*/
function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory data) public virtual override {
require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC721: caller is not token owner or approved");
_safeTransfer(from, to, tokenId, data);
}
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* `data` is additional data, it has no specified format and it is sent in call to `to`.
*
* This internal function is equivalent to {safeTransferFrom}, and can be used to e.g.
* implement alternative mechanisms to perform token transfer, such as signature-based.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeTransfer(address from, address to, uint256 tokenId, bytes memory data) internal virtual {
_transfer(from, to, tokenId);
require(_checkOnERC721Received(from, to, tokenId, data), "ERC721: transfer to non ERC721Receiver implementer");
}
/**
* @dev Returns the owner of the `tokenId`. Does NOT revert if token doesn't exist
*/
function _ownerOf(uint256 tokenId) internal view virtual returns (address) {
return _owners[tokenId];
}
/**
* @dev Returns whether `tokenId` exists.
*
* Tokens can be managed by their owner or approved accounts via {approve} or {setApprovalForAll}.
*
* Tokens start existing when they are minted (`_mint`),
* and stop existing when they are burned (`_burn`).
*/
function _exists(uint256 tokenId) internal view virtual returns (bool) {
return _ownerOf(tokenId) != address(0);
}
/**
* @dev Returns whether `spender` is allowed to manage `tokenId`.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function _isApprovedOrOwner(address spender, uint256 tokenId) internal view virtual returns (bool) {
address owner = ERC721.ownerOf(tokenId);
return (spender == owner || isApprovedForAll(owner, spender) || getApproved(tokenId) == spender);
}
/**
* @dev Safely mints `tokenId` and transfers it to `to`.
*
* Requirements:
*
* - `tokenId` must not exist.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function _safeMint(address to, uint256 tokenId) internal virtual {
_safeMint(to, tokenId, "");
}
/**
* @dev Same as {xref-ERC721-_safeMint-address-uint256-}[`_safeMint`], with an additional `data` parameter which is
* forwarded in {IERC721Receiver-onERC721Received} to contract recipients.
*/
function _safeMint(address to, uint256 tokenId, bytes memory data) internal virtual {
_mint(to, tokenId);
require(
_checkOnERC721Received(address(0), to, tokenId, data),
"ERC721: transfer to non ERC721Receiver implementer"
);
}
/**
* @dev Mints `tokenId` and transfers it to `to`.
*
* WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible
*
* Requirements:
*
* - `tokenId` must not exist.
* - `to` cannot be the zero address.
*
* Emits a {Transfer} event.
*/
function _mint(address to, uint256 tokenId) internal virtual {
require(to != address(0), "ERC721: mint to the zero address");
require(!_exists(tokenId), "ERC721: token already minted");
_beforeTokenTransfer(address(0), to, tokenId, 1);
// Check that tokenId was not minted by `_beforeTokenTransfer` hook
require(!_exists(tokenId), "ERC721: token already minted");
unchecked {
// Will not overflow unless all 2**256 token ids are minted to the same owner.
// Given that tokens are minted one by one, it is impossible in practice that
// this ever happens. Might change if we allow batch minting.
// The ERC fails to describe this case.
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(address(0), to, tokenId);
_afterTokenTransfer(address(0), to, tokenId, 1);
}
/**
* @dev Destroys `tokenId`.
* The approval is cleared when the token is burned.
* This is an internal function that does not check if the sender is authorized to operate on the token.
*
* Requirements:
*
* - `tokenId` must exist.
*
* Emits a {Transfer} event.
*/
function _burn(uint256 tokenId) internal virtual {
address owner = ERC721.ownerOf(tokenId);
_beforeTokenTransfer(owner, address(0), tokenId, 1);
// Update ownership in case tokenId was transferred by `_beforeTokenTransfer` hook
owner = ERC721.ownerOf(tokenId);
// Clear approvals
delete _tokenApprovals[tokenId];
unchecked {
// Cannot overflow, as that would require more tokens to be burned/transferred
// out than the owner initially received through minting and transferring in.
_balances[owner] -= 1;
}
delete _owners[tokenId];
emit Transfer(owner, address(0), tokenId);
_afterTokenTransfer(owner, address(0), tokenId, 1);
}
/**
* @dev Transfers `tokenId` from `from` to `to`.
* As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
*
* Requirements:
*
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
*
* Emits a {Transfer} event.
*/
function _transfer(address from, address to, uint256 tokenId) internal virtual {
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
require(to != address(0), "ERC721: transfer to the zero address");
_beforeTokenTransfer(from, to, tokenId, 1);
// Check that tokenId was not transferred by `_beforeTokenTransfer` hook
require(ERC721.ownerOf(tokenId) == from, "ERC721: transfer from incorrect owner");
// Clear approvals from the previous owner
delete _tokenApprovals[tokenId];
unchecked {
// `_balances[from]` cannot overflow for the same reason as described in `_burn`:
// `from`'s balance is the number of token held, which is at least one before the current
// transfer.
// `_balances[to]` could overflow in the conditions described in `_mint`. That would require
// all 2**256 token ids to be minted, which in practice is impossible.
_balances[from] -= 1;
_balances[to] += 1;
}
_owners[tokenId] = to;
emit Transfer(from, to, tokenId);
_afterTokenTransfer(from, to, tokenId, 1);
}
/**
* @dev Approve `to` to operate on `tokenId`
*
* Emits an {Approval} event.
*/
function _approve(address to, uint256 tokenId) internal virtual {
_tokenApprovals[tokenId] = to;
emit Approval(ERC721.ownerOf(tokenId), to, tokenId);
}
/**
* @dev Approve `operator` to operate on all of `owner` tokens
*
* Emits an {ApprovalForAll} event.
*/
function _setApprovalForAll(address owner, address operator, bool approved) internal virtual {
require(owner != operator, "ERC721: approve to caller");
_operatorApprovals[owner][operator] = approved;
emit ApprovalForAll(owner, operator, approved);
}
/**
* @dev Reverts if the `tokenId` has not been minted yet.
*/
function _requireMinted(uint256 tokenId) internal view virtual {
require(_exists(tokenId), "ERC721: invalid token ID");
}
/**
* @dev Internal function to invoke {IERC721Receiver-onERC721Received} on a target address.
* The call is not executed if the target address is not a contract.
*
* @param from address representing the previous owner of the given token ID
* @param to target address that will receive the tokens
* @param tokenId uint256 ID of the token to be transferred
* @param data bytes optional data to send along with the call
* @return bool whether the call correctly returned the expected magic value
*/
function _checkOnERC721Received(
address from,
address to,
uint256 tokenId,
bytes memory data
) private returns (bool) {
if (to.isContract()) {
try IERC721Receiver(to).onERC721Received(_msgSender(), from, tokenId, data) returns (bytes4 retval) {
return retval == IERC721Receiver.onERC721Received.selector;
} catch (bytes memory reason) {
if (reason.length == 0) {
revert("ERC721: transfer to non ERC721Receiver implementer");
} else {
/// @solidity memory-safe-assembly
assembly {
revert(add(32, reason), mload(reason))
}
}
}
} else {
return true;
}
}
/**
* @dev Hook that is called before any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens will be transferred to `to`.
* - When `from` is zero, the tokens will be minted for `to`.
* - When `to` is zero, ``from``'s tokens will be burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _beforeTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
/**
* @dev Hook that is called after any token transfer. This includes minting and burning. If {ERC721Consecutive} is
* used, the hook may be called as part of a consecutive (batch) mint, as indicated by `batchSize` greater than 1.
*
* Calling conditions:
*
* - When `from` and `to` are both non-zero, ``from``'s tokens were transferred to `to`.
* - When `from` is zero, the tokens were minted for `to`.
* - When `to` is zero, ``from``'s tokens were burned.
* - `from` and `to` are never both zero.
* - `batchSize` is non-zero.
*
* To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
*/
function _afterTokenTransfer(address from, address to, uint256 firstTokenId, uint256 batchSize) internal virtual {}
/**
* @dev Unsafe write access to the balances, used by extensions that "mint" tokens using an {ownerOf} override.
*
* WARNING: Anyone calling this MUST ensure that the balances remain consistent with the ownership. The invariant
* being that for any address `a` the value returned by `balanceOf(a)` must be equal to the number of tokens such
* that `ownerOf(tokenId)` is `a`.
*/
// solhint-disable-next-line func-name-mixedcase
function __unsafe_increaseBalance(address account, uint256 amount) internal {
_balances[account] += amount;
}
}
ERC721Enumerable.sol 159 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (token/ERC721/extensions/ERC721Enumerable.sol)
pragma solidity ^0.8.0;
import "../ERC721.sol";
import "./IERC721Enumerable.sol";
/**
* @dev This implements an optional extension of {ERC721} defined in the EIP that adds
* enumerability of all the token ids in the contract as well as all token ids owned by each
* account.
*/
abstract contract ERC721Enumerable is ERC721, IERC721Enumerable {
// Mapping from owner to list of owned token IDs
mapping(address => mapping(uint256 => uint256)) private _ownedTokens;
// Mapping from token ID to index of the owner tokens list
mapping(uint256 => uint256) private _ownedTokensIndex;
// Array with all token ids, used for enumeration
uint256[] private _allTokens;
// Mapping from token id to position in the allTokens array
mapping(uint256 => uint256) private _allTokensIndex;
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165, ERC721) returns (bool) {
return interfaceId == type(IERC721Enumerable).interfaceId || super.supportsInterface(interfaceId);
}
/**
* @dev See {IERC721Enumerable-tokenOfOwnerByIndex}.
*/
function tokenOfOwnerByIndex(address owner, uint256 index) public view virtual override returns (uint256) {
require(index < ERC721.balanceOf(owner), "ERC721Enumerable: owner index out of bounds");
return _ownedTokens[owner][index];
}
/**
* @dev See {IERC721Enumerable-totalSupply}.
*/
function totalSupply() public view virtual override returns (uint256) {
return _allTokens.length;
}
/**
* @dev See {IERC721Enumerable-tokenByIndex}.
*/
function tokenByIndex(uint256 index) public view virtual override returns (uint256) {
require(index < ERC721Enumerable.totalSupply(), "ERC721Enumerable: global index out of bounds");
return _allTokens[index];
}
/**
* @dev See {ERC721-_beforeTokenTransfer}.
*/
function _beforeTokenTransfer(
address from,
address to,
uint256 firstTokenId,
uint256 batchSize
) internal virtual override {
super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
if (batchSize > 1) {
// Will only trigger during construction. Batch transferring (minting) is not available afterwards.
revert("ERC721Enumerable: consecutive transfers not supported");
}
uint256 tokenId = firstTokenId;
if (from == address(0)) {
_addTokenToAllTokensEnumeration(tokenId);
} else if (from != to) {
_removeTokenFromOwnerEnumeration(from, tokenId);
}
if (to == address(0)) {
_removeTokenFromAllTokensEnumeration(tokenId);
} else if (to != from) {
_addTokenToOwnerEnumeration(to, tokenId);
}
}
/**
* @dev Private function to add a token to this extension's ownership-tracking data structures.
* @param to address representing the new owner of the given token ID
* @param tokenId uint256 ID of the token to be added to the tokens list of the given address
*/
function _addTokenToOwnerEnumeration(address to, uint256 tokenId) private {
uint256 length = ERC721.balanceOf(to);
_ownedTokens[to][length] = tokenId;
_ownedTokensIndex[tokenId] = length;
}
/**
* @dev Private function to add a token to this extension's token tracking data structures.
* @param tokenId uint256 ID of the token to be added to the tokens list
*/
function _addTokenToAllTokensEnumeration(uint256 tokenId) private {
_allTokensIndex[tokenId] = _allTokens.length;
_allTokens.push(tokenId);
}
/**
* @dev Private function to remove a token from this extension's ownership-tracking data structures. Note that
* while the token is not assigned a new owner, the `_ownedTokensIndex` mapping is _not_ updated: this allows for
* gas optimizations e.g. when performing a transfer operation (avoiding double writes).
* This has O(1) time complexity, but alters the order of the _ownedTokens array.
* @param from address representing the previous owner of the given token ID
* @param tokenId uint256 ID of the token to be removed from the tokens list of the given address
*/
function _removeTokenFromOwnerEnumeration(address from, uint256 tokenId) private {
// To prevent a gap in from's tokens array, we store the last token in the index of the token to delete, and
// then delete the last slot (swap and pop).
uint256 lastTokenIndex = ERC721.balanceOf(from) - 1;
uint256 tokenIndex = _ownedTokensIndex[tokenId];
// When the token to delete is the last token, the swap operation is unnecessary
if (tokenIndex != lastTokenIndex) {
uint256 lastTokenId = _ownedTokens[from][lastTokenIndex];
_ownedTokens[from][tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
_ownedTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
}
// This also deletes the contents at the last position of the array
delete _ownedTokensIndex[tokenId];
delete _ownedTokens[from][lastTokenIndex];
}
/**
* @dev Private function to remove a token from this extension's token tracking data structures.
* This has O(1) time complexity, but alters the order of the _allTokens array.
* @param tokenId uint256 ID of the token to be removed from the tokens list
*/
function _removeTokenFromAllTokensEnumeration(uint256 tokenId) private {
// To prevent a gap in the tokens array, we store the last token in the index of the token to delete, and
// then delete the last slot (swap and pop).
uint256 lastTokenIndex = _allTokens.length - 1;
uint256 tokenIndex = _allTokensIndex[tokenId];
// When the token to delete is the last token, the swap operation is unnecessary. However, since this occurs so
// rarely (when the last minted token is burnt) that we still do the swap here to avoid the gas cost of adding
// an 'if' statement (like in _removeTokenFromOwnerEnumeration)
uint256 lastTokenId = _allTokens[lastTokenIndex];
_allTokens[tokenIndex] = lastTokenId; // Move the last token to the slot of the to-delete token
_allTokensIndex[lastTokenId] = tokenIndex; // Update the moved token's index
// This also deletes the contents at the last position of the array
delete _allTokensIndex[tokenId];
_allTokens.pop();
}
}
IERC721Enumerable.sol 29 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.5.0) (token/ERC721/extensions/IERC721Enumerable.sol)
pragma solidity ^0.8.0;
import "../IERC721.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional enumeration extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721Enumerable is IERC721 {
/**
* @dev Returns the total amount of tokens stored by the contract.
*/
function totalSupply() external view returns (uint256);
/**
* @dev Returns a token ID owned by `owner` at a given `index` of its token list.
* Use along with {balanceOf} to enumerate all of ``owner``'s tokens.
*/
function tokenOfOwnerByIndex(address owner, uint256 index) external view returns (uint256);
/**
* @dev Returns a token ID at a given `index` of all the tokens stored by the contract.
* Use along with {totalSupply} to enumerate all tokens.
*/
function tokenByIndex(uint256 index) external view returns (uint256);
}
IERC721Metadata.sol 27 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (token/ERC721/extensions/IERC721Metadata.sol)
pragma solidity ^0.8.0;
import "../IERC721.sol";
/**
* @title ERC-721 Non-Fungible Token Standard, optional metadata extension
* @dev See https://eips.ethereum.org/EIPS/eip-721
*/
interface IERC721Metadata is IERC721 {
/**
* @dev Returns the token collection name.
*/
function name() external view returns (string memory);
/**
* @dev Returns the token collection symbol.
*/
function symbol() external view returns (string memory);
/**
* @dev Returns the Uniform Resource Identifier (URI) for `tokenId` token.
*/
function tokenURI(uint256 tokenId) external view returns (string memory);
}
IERC721.sol 132 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (token/ERC721/IERC721.sol)
pragma solidity ^0.8.0;
import "../../utils/introspection/IERC165.sol";
/**
* @dev Required interface of an ERC721 compliant contract.
*/
interface IERC721 is IERC165 {
/**
* @dev Emitted when `tokenId` token is transferred from `from` to `to`.
*/
event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables `approved` to manage the `tokenId` token.
*/
event Approval(address indexed owner, address indexed approved, uint256 indexed tokenId);
/**
* @dev Emitted when `owner` enables or disables (`approved`) `operator` to manage all of its assets.
*/
event ApprovalForAll(address indexed owner, address indexed operator, bool approved);
/**
* @dev Returns the number of tokens in ``owner``'s account.
*/
function balanceOf(address owner) external view returns (uint256 balance);
/**
* @dev Returns the owner of the `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function ownerOf(uint256 tokenId) external view returns (address owner);
/**
* @dev Safely transfers `tokenId` token from `from` to `to`.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(address from, address to, uint256 tokenId, bytes calldata data) external;
/**
* @dev Safely transfers `tokenId` token from `from` to `to`, checking first that contract recipients
* are aware of the ERC721 protocol to prevent tokens from being forever locked.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must exist and be owned by `from`.
* - If the caller is not `from`, it must have been allowed to move this token by either {approve} or {setApprovalForAll}.
* - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
*
* Emits a {Transfer} event.
*/
function safeTransferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Transfers `tokenId` token from `from` to `to`.
*
* WARNING: Note that the caller is responsible to confirm that the recipient is capable of receiving ERC721
* or else they may be permanently lost. Usage of {safeTransferFrom} prevents loss, though the caller must
* understand this adds an external call which potentially creates a reentrancy vulnerability.
*
* Requirements:
*
* - `from` cannot be the zero address.
* - `to` cannot be the zero address.
* - `tokenId` token must be owned by `from`.
* - If the caller is not `from`, it must be approved to move this token by either {approve} or {setApprovalForAll}.
*
* Emits a {Transfer} event.
*/
function transferFrom(address from, address to, uint256 tokenId) external;
/**
* @dev Gives permission to `to` to transfer `tokenId` token to another account.
* The approval is cleared when the token is transferred.
*
* Only a single account can be approved at a time, so approving the zero address clears previous approvals.
*
* Requirements:
*
* - The caller must own the token or be an approved operator.
* - `tokenId` must exist.
*
* Emits an {Approval} event.
*/
function approve(address to, uint256 tokenId) external;
/**
* @dev Approve or remove `operator` as an operator for the caller.
* Operators can call {transferFrom} or {safeTransferFrom} for any token owned by the caller.
*
* Requirements:
*
* - The `operator` cannot be the caller.
*
* Emits an {ApprovalForAll} event.
*/
function setApprovalForAll(address operator, bool approved) external;
/**
* @dev Returns the account approved for `tokenId` token.
*
* Requirements:
*
* - `tokenId` must exist.
*/
function getApproved(uint256 tokenId) external view returns (address operator);
/**
* @dev Returns if the `operator` is allowed to manage all of the assets of `owner`.
*
* See {setApprovalForAll}
*/
function isApprovedForAll(address owner, address operator) external view returns (bool);
}
IERC721Receiver.sol 27 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.6.0) (token/ERC721/IERC721Receiver.sol)
pragma solidity ^0.8.0;
/**
* @title ERC721 token receiver interface
* @dev Interface for any contract that wants to support safeTransfers
* from ERC721 asset contracts.
*/
interface IERC721Receiver {
/**
* @dev Whenever an {IERC721} `tokenId` token is transferred to this contract via {IERC721-safeTransferFrom}
* by `operator` from `from`, this function is called.
*
* It must return its Solidity selector to confirm the token transfer.
* If any other value is returned or the interface is not implemented by the recipient, the transfer will be reverted.
*
* The selector can be obtained in Solidity with `IERC721Receiver.onERC721Received.selector`.
*/
function onERC721Received(
address operator,
address from,
uint256 tokenId,
bytes calldata data
) external returns (bytes4);
}
Address.sol 244 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Address.sol)
pragma solidity ^0.8.1;
/**
* @dev Collection of functions related to the address type
*/
library Address {
/**
* @dev Returns true if `account` is a contract.
*
* [IMPORTANT]
* ====
* It is unsafe to assume that an address for which this function returns
* false is an externally-owned account (EOA) and not a contract.
*
* Among others, `isContract` will return false for the following
* types of addresses:
*
* - an externally-owned account
* - a contract in construction
* - an address where a contract will be created
* - an address where a contract lived, but was destroyed
*
* Furthermore, `isContract` will also return true if the target contract within
* the same transaction is already scheduled for destruction by `SELFDESTRUCT`,
* which only has an effect at the end of a transaction.
* ====
*
* [IMPORTANT]
* ====
* You shouldn't rely on `isContract` to protect against flash loan attacks!
*
* Preventing calls from contracts is highly discouraged. It breaks composability, breaks support for smart wallets
* like Gnosis Safe, and does not provide security since it can be circumvented by calling from a contract
* constructor.
* ====
*/
function isContract(address account) internal view returns (bool) {
// This method relies on extcodesize/address.code.length, which returns 0
// for contracts in construction, since the code is only stored at the end
// of the constructor execution.
return account.code.length > 0;
}
/**
* @dev Replacement for Solidity's `transfer`: sends `amount` wei to
* `recipient`, forwarding all available gas and reverting on errors.
*
* https://eips.ethereum.org/EIPS/eip-1884[EIP1884] increases the gas cost
* of certain opcodes, possibly making contracts go over the 2300 gas limit
* imposed by `transfer`, making them unable to receive funds via
* `transfer`. {sendValue} removes this limitation.
*
* https://consensys.net/diligence/blog/2019/09/stop-using-soliditys-transfer-now/[Learn more].
*
* IMPORTANT: because control is transferred to `recipient`, care must be
* taken to not create reentrancy vulnerabilities. Consider using
* {ReentrancyGuard} or the
* https://solidity.readthedocs.io/en/v0.8.0/security-considerations.html#use-the-checks-effects-interactions-pattern[checks-effects-interactions pattern].
*/
function sendValue(address payable recipient, uint256 amount) internal {
require(address(this).balance >= amount, "Address: insufficient balance");
(bool success, ) = recipient.call{value: amount}("");
require(success, "Address: unable to send value, recipient may have reverted");
}
/**
* @dev Performs a Solidity function call using a low level `call`. A
* plain `call` is an unsafe replacement for a function call: use this
* function instead.
*
* If `target` reverts with a revert reason, it is bubbled up by this
* function (like regular Solidity function calls).
*
* Returns the raw returned data. To convert to the expected return value,
* use https://solidity.readthedocs.io/en/latest/units-and-global-variables.html?highlight=abi.decode#abi-encoding-and-decoding-functions[`abi.decode`].
*
* Requirements:
*
* - `target` must be a contract.
* - calling `target` with `data` must not revert.
*
* _Available since v3.1._
*/
function functionCall(address target, bytes memory data) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, "Address: low-level call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`], but with
* `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
return functionCallWithValue(target, data, 0, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but also transferring `value` wei to `target`.
*
* Requirements:
*
* - the calling contract must have an ETH balance of at least `value`.
* - the called Solidity function must be `payable`.
*
* _Available since v3.1._
*/
function functionCallWithValue(address target, bytes memory data, uint256 value) internal returns (bytes memory) {
return functionCallWithValue(target, data, value, "Address: low-level call with value failed");
}
/**
* @dev Same as {xref-Address-functionCallWithValue-address-bytes-uint256-}[`functionCallWithValue`], but
* with `errorMessage` as a fallback revert reason when `target` reverts.
*
* _Available since v3.1._
*/
function functionCallWithValue(
address target,
bytes memory data,
uint256 value,
string memory errorMessage
) internal returns (bytes memory) {
require(address(this).balance >= value, "Address: insufficient balance for call");
(bool success, bytes memory returndata) = target.call{value: value}(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(address target, bytes memory data) internal view returns (bytes memory) {
return functionStaticCall(target, data, "Address: low-level static call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a static call.
*
* _Available since v3.3._
*/
function functionStaticCall(
address target,
bytes memory data,
string memory errorMessage
) internal view returns (bytes memory) {
(bool success, bytes memory returndata) = target.staticcall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(address target, bytes memory data) internal returns (bytes memory) {
return functionDelegateCall(target, data, "Address: low-level delegate call failed");
}
/**
* @dev Same as {xref-Address-functionCall-address-bytes-string-}[`functionCall`],
* but performing a delegate call.
*
* _Available since v3.4._
*/
function functionDelegateCall(
address target,
bytes memory data,
string memory errorMessage
) internal returns (bytes memory) {
(bool success, bytes memory returndata) = target.delegatecall(data);
return verifyCallResultFromTarget(target, success, returndata, errorMessage);
}
/**
* @dev Tool to verify that a low level call to smart-contract was successful, and revert (either by bubbling
* the revert reason or using the provided one) in case of unsuccessful call or if target was not a contract.
*
* _Available since v4.8._
*/
function verifyCallResultFromTarget(
address target,
bool success,
bytes memory returndata,
string memory errorMessage
) internal view returns (bytes memory) {
if (success) {
if (returndata.length == 0) {
// only check isContract if the call was successful and the return data is empty
// otherwise we already know that it was a contract
require(isContract(target), "Address: call to non-contract");
}
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
/**
* @dev Tool to verify that a low level call was successful, and revert if it wasn't, either by bubbling the
* revert reason or using the provided one.
*
* _Available since v4.3._
*/
function verifyCallResult(
bool success,
bytes memory returndata,
string memory errorMessage
) internal pure returns (bytes memory) {
if (success) {
return returndata;
} else {
_revert(returndata, errorMessage);
}
}
function _revert(bytes memory returndata, string memory errorMessage) private pure {
// Look for revert reason and bubble it up if present
if (returndata.length > 0) {
// The easiest way to bubble the revert reason is using memory via assembly
/// @solidity memory-safe-assembly
assembly {
let returndata_size := mload(returndata)
revert(add(32, returndata), returndata_size)
}
} else {
revert(errorMessage);
}
}
}
Context.sol 28 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.4) (utils/Context.sol)
pragma solidity ^0.8.0;
/**
* @dev Provides information about the current execution context, including the
* sender of the transaction and its data. While these are generally available
* via msg.sender and msg.data, they should not be accessed in such a direct
* manner, since when dealing with meta-transactions the account sending and
* paying for execution may not be the actual sender (as far as an application
* is concerned).
*
* This contract is only required for intermediate, library-like contracts.
*/
abstract contract Context {
function _msgSender() internal view virtual returns (address) {
return msg.sender;
}
function _msgData() internal view virtual returns (bytes calldata) {
return msg.data;
}
function _contextSuffixLength() internal view virtual returns (uint256) {
return 0;
}
}
ERC165.sol 29 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
pragma solidity ^0.8.0;
import "./IERC165.sol";
/**
* @dev Implementation of the {IERC165} interface.
*
* Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
* for the additional interface id that will be supported. For example:
*
* ```solidity
* function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
* return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
* }
* ```
*
* Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
*/
abstract contract ERC165 is IERC165 {
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
return interfaceId == type(IERC165).interfaceId;
}
}
IERC165.sol 25 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
pragma solidity ^0.8.0;
/**
* @dev Interface of the ERC165 standard, as defined in the
* https://eips.ethereum.org/EIPS/eip-165[EIP].
*
* Implementers can declare support of contract interfaces, which can then be
* queried by others ({ERC165Checker}).
*
* For an implementation, see {ERC165}.
*/
interface IERC165 {
/**
* @dev Returns true if this contract implements the interface defined by
* `interfaceId`. See the corresponding
* https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
* to learn more about how these ids are created.
*
* This function call must use less than 30 000 gas.
*/
function supportsInterface(bytes4 interfaceId) external view returns (bool);
}
Math.sol 339 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/math/Math.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard math utilities missing in the Solidity language.
*/
library Math {
enum Rounding {
Down, // Toward negative infinity
Up, // Toward infinity
Zero // Toward zero
}
/**
* @dev Returns the largest of two numbers.
*/
function max(uint256 a, uint256 b) internal pure returns (uint256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two numbers.
*/
function min(uint256 a, uint256 b) internal pure returns (uint256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two numbers. The result is rounded towards
* zero.
*/
function average(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b) / 2 can overflow.
return (a & b) + (a ^ b) / 2;
}
/**
* @dev Returns the ceiling of the division of two numbers.
*
* This differs from standard division with `/` in that it rounds up instead
* of rounding down.
*/
function ceilDiv(uint256 a, uint256 b) internal pure returns (uint256) {
// (a + b - 1) / b can overflow on addition, so we distribute.
return a == 0 ? 0 : (a - 1) / b + 1;
}
/**
* @notice Calculates floor(x * y / denominator) with full precision. Throws if result overflows a uint256 or denominator == 0
* @dev Original credit to Remco Bloemen under MIT license (https://xn--2-umb.com/21/muldiv)
* with further edits by Uniswap Labs also under MIT license.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator) internal pure returns (uint256 result) {
unchecked {
// 512-bit multiply [prod1 prod0] = x * y. Compute the product mod 2^256 and mod 2^256 - 1, then use
// use the Chinese Remainder Theorem to reconstruct the 512 bit result. The result is stored in two 256
// variables such that product = prod1 * 2^256 + prod0.
uint256 prod0; // Least significant 256 bits of the product
uint256 prod1; // Most significant 256 bits of the product
assembly {
let mm := mulmod(x, y, not(0))
prod0 := mul(x, y)
prod1 := sub(sub(mm, prod0), lt(mm, prod0))
}
// Handle non-overflow cases, 256 by 256 division.
if (prod1 == 0) {
// Solidity will revert if denominator == 0, unlike the div opcode on its own.
// The surrounding unchecked block does not change this fact.
// See https://docs.soliditylang.org/en/latest/control-structures.html#checked-or-unchecked-arithmetic.
return prod0 / denominator;
}
// Make sure the result is less than 2^256. Also prevents denominator == 0.
require(denominator > prod1, "Math: mulDiv overflow");
///////////////////////////////////////////////
// 512 by 256 division.
///////////////////////////////////////////////
// Make division exact by subtracting the remainder from [prod1 prod0].
uint256 remainder;
assembly {
// Compute remainder using mulmod.
remainder := mulmod(x, y, denominator)
// Subtract 256 bit number from 512 bit number.
prod1 := sub(prod1, gt(remainder, prod0))
prod0 := sub(prod0, remainder)
}
// Factor powers of two out of denominator and compute largest power of two divisor of denominator. Always >= 1.
// See https://cs.stackexchange.com/q/138556/92363.
// Does not overflow because the denominator cannot be zero at this stage in the function.
uint256 twos = denominator & (~denominator + 1);
assembly {
// Divide denominator by twos.
denominator := div(denominator, twos)
// Divide [prod1 prod0] by twos.
prod0 := div(prod0, twos)
// Flip twos such that it is 2^256 / twos. If twos is zero, then it becomes one.
twos := add(div(sub(0, twos), twos), 1)
}
// Shift in bits from prod1 into prod0.
prod0 |= prod1 * twos;
// Invert denominator mod 2^256. Now that denominator is an odd number, it has an inverse modulo 2^256 such
// that denominator * inv = 1 mod 2^256. Compute the inverse by starting with a seed that is correct for
// four bits. That is, denominator * inv = 1 mod 2^4.
uint256 inverse = (3 * denominator) ^ 2;
// Use the Newton-Raphson iteration to improve the precision. Thanks to Hensel's lifting lemma, this also works
// in modular arithmetic, doubling the correct bits in each step.
inverse *= 2 - denominator * inverse; // inverse mod 2^8
inverse *= 2 - denominator * inverse; // inverse mod 2^16
inverse *= 2 - denominator * inverse; // inverse mod 2^32
inverse *= 2 - denominator * inverse; // inverse mod 2^64
inverse *= 2 - denominator * inverse; // inverse mod 2^128
inverse *= 2 - denominator * inverse; // inverse mod 2^256
// Because the division is now exact we can divide by multiplying with the modular inverse of denominator.
// This will give us the correct result modulo 2^256. Since the preconditions guarantee that the outcome is
// less than 2^256, this is the final result. We don't need to compute the high bits of the result and prod1
// is no longer required.
result = prod0 * inverse;
return result;
}
}
/**
* @notice Calculates x * y / denominator with full precision, following the selected rounding direction.
*/
function mulDiv(uint256 x, uint256 y, uint256 denominator, Rounding rounding) internal pure returns (uint256) {
uint256 result = mulDiv(x, y, denominator);
if (rounding == Rounding.Up && mulmod(x, y, denominator) > 0) {
result += 1;
}
return result;
}
/**
* @dev Returns the square root of a number. If the number is not a perfect square, the value is rounded down.
*
* Inspired by Henry S. Warren, Jr.'s "Hacker's Delight" (Chapter 11).
*/
function sqrt(uint256 a) internal pure returns (uint256) {
if (a == 0) {
return 0;
}
// For our first guess, we get the biggest power of 2 which is smaller than the square root of the target.
//
// We know that the "msb" (most significant bit) of our target number `a` is a power of 2 such that we have
// `msb(a) <= a < 2*msb(a)`. This value can be written `msb(a)=2**k` with `k=log2(a)`.
//
// This can be rewritten `2**log2(a) <= a < 2**(log2(a) + 1)`
// → `sqrt(2**k) <= sqrt(a) < sqrt(2**(k+1))`
// → `2**(k/2) <= sqrt(a) < 2**((k+1)/2) <= 2**(k/2 + 1)`
//
// Consequently, `2**(log2(a) / 2)` is a good first approximation of `sqrt(a)` with at least 1 correct bit.
uint256 result = 1 << (log2(a) >> 1);
// At this point `result` is an estimation with one bit of precision. We know the true value is a uint128,
// since it is the square root of a uint256. Newton's method converges quadratically (precision doubles at
// every iteration). We thus need at most 7 iteration to turn our partial result with one bit of precision
// into the expected uint128 result.
unchecked {
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
result = (result + a / result) >> 1;
return min(result, a / result);
}
}
/**
* @notice Calculates sqrt(a), following the selected rounding direction.
*/
function sqrt(uint256 a, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = sqrt(a);
return result + (rounding == Rounding.Up && result * result < a ? 1 : 0);
}
}
/**
* @dev Return the log in base 2, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 128;
}
if (value >> 64 > 0) {
value >>= 64;
result += 64;
}
if (value >> 32 > 0) {
value >>= 32;
result += 32;
}
if (value >> 16 > 0) {
value >>= 16;
result += 16;
}
if (value >> 8 > 0) {
value >>= 8;
result += 8;
}
if (value >> 4 > 0) {
value >>= 4;
result += 4;
}
if (value >> 2 > 0) {
value >>= 2;
result += 2;
}
if (value >> 1 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 2, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log2(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log2(value);
return result + (rounding == Rounding.Up && 1 << result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 10, rounded down, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >= 10 ** 64) {
value /= 10 ** 64;
result += 64;
}
if (value >= 10 ** 32) {
value /= 10 ** 32;
result += 32;
}
if (value >= 10 ** 16) {
value /= 10 ** 16;
result += 16;
}
if (value >= 10 ** 8) {
value /= 10 ** 8;
result += 8;
}
if (value >= 10 ** 4) {
value /= 10 ** 4;
result += 4;
}
if (value >= 10 ** 2) {
value /= 10 ** 2;
result += 2;
}
if (value >= 10 ** 1) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 10, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log10(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log10(value);
return result + (rounding == Rounding.Up && 10 ** result < value ? 1 : 0);
}
}
/**
* @dev Return the log in base 256, rounded down, of a positive value.
* Returns 0 if given 0.
*
* Adding one to the result gives the number of pairs of hex symbols needed to represent `value` as a hex string.
*/
function log256(uint256 value) internal pure returns (uint256) {
uint256 result = 0;
unchecked {
if (value >> 128 > 0) {
value >>= 128;
result += 16;
}
if (value >> 64 > 0) {
value >>= 64;
result += 8;
}
if (value >> 32 > 0) {
value >>= 32;
result += 4;
}
if (value >> 16 > 0) {
value >>= 16;
result += 2;
}
if (value >> 8 > 0) {
result += 1;
}
}
return result;
}
/**
* @dev Return the log in base 256, following the selected rounding direction, of a positive value.
* Returns 0 if given 0.
*/
function log256(uint256 value, Rounding rounding) internal pure returns (uint256) {
unchecked {
uint256 result = log256(value);
return result + (rounding == Rounding.Up && 1 << (result << 3) < value ? 1 : 0);
}
}
}
SignedMath.sol 43 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.8.0) (utils/math/SignedMath.sol)
pragma solidity ^0.8.0;
/**
* @dev Standard signed math utilities missing in the Solidity language.
*/
library SignedMath {
/**
* @dev Returns the largest of two signed numbers.
*/
function max(int256 a, int256 b) internal pure returns (int256) {
return a > b ? a : b;
}
/**
* @dev Returns the smallest of two signed numbers.
*/
function min(int256 a, int256 b) internal pure returns (int256) {
return a < b ? a : b;
}
/**
* @dev Returns the average of two signed numbers without overflow.
* The result is rounded towards zero.
*/
function average(int256 a, int256 b) internal pure returns (int256) {
// Formula from the book "Hacker's Delight"
int256 x = (a & b) + ((a ^ b) >> 1);
return x + (int256(uint256(x) >> 255) & (a ^ b));
}
/**
* @dev Returns the absolute unsigned value of a signed value.
*/
function abs(int256 n) internal pure returns (uint256) {
unchecked {
// must be unchecked in order to support `n = type(int256).min`
return uint256(n >= 0 ? n : -n);
}
}
}
Strings.sol 85 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/Strings.sol)
pragma solidity ^0.8.0;
import "./math/Math.sol";
import "./math/SignedMath.sol";
/**
* @dev String operations.
*/
library Strings {
bytes16 private constant _SYMBOLS = "0123456789abcdef";
uint8 private constant _ADDRESS_LENGTH = 20;
/**
* @dev Converts a `uint256` to its ASCII `string` decimal representation.
*/
function toString(uint256 value) internal pure returns (string memory) {
unchecked {
uint256 length = Math.log10(value) + 1;
string memory buffer = new string(length);
uint256 ptr;
/// @solidity memory-safe-assembly
assembly {
ptr := add(buffer, add(32, length))
}
while (true) {
ptr--;
/// @solidity memory-safe-assembly
assembly {
mstore8(ptr, byte(mod(value, 10), _SYMBOLS))
}
value /= 10;
if (value == 0) break;
}
return buffer;
}
}
/**
* @dev Converts a `int256` to its ASCII `string` decimal representation.
*/
function toString(int256 value) internal pure returns (string memory) {
return string(abi.encodePacked(value < 0 ? "-" : "", toString(SignedMath.abs(value))));
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation.
*/
function toHexString(uint256 value) internal pure returns (string memory) {
unchecked {
return toHexString(value, Math.log256(value) + 1);
}
}
/**
* @dev Converts a `uint256` to its ASCII `string` hexadecimal representation with fixed length.
*/
function toHexString(uint256 value, uint256 length) internal pure returns (string memory) {
bytes memory buffer = new bytes(2 * length + 2);
buffer[0] = "0";
buffer[1] = "x";
for (uint256 i = 2 * length + 1; i > 1; --i) {
buffer[i] = _SYMBOLS[value & 0xf];
value >>= 4;
}
require(value == 0, "Strings: hex length insufficient");
return string(buffer);
}
/**
* @dev Converts an `address` with fixed length of 20 bytes to its not checksummed ASCII `string` hexadecimal representation.
*/
function toHexString(address addr) internal pure returns (string memory) {
return toHexString(uint256(uint160(addr)), _ADDRESS_LENGTH);
}
/**
* @dev Returns true if the two strings are equal.
*/
function equal(string memory a, string memory b) internal pure returns (bool) {
return keccak256(bytes(a)) == keccak256(bytes(b));
}
}
EnumerableSet.sol 378 lines
// SPDX-License-Identifier: MIT
// OpenZeppelin Contracts (last updated v4.9.0) (utils/structs/EnumerableSet.sol)
// This file was procedurally generated from scripts/generate/templates/EnumerableSet.js.
pragma solidity ^0.8.0;
/**
* @dev Library for managing
* https://en.wikipedia.org/wiki/Set_(abstract_data_type)[sets] of primitive
* types.
*
* Sets have the following properties:
*
* - Elements are added, removed, and checked for existence in constant time
* (O(1)).
* - Elements are enumerated in O(n). No guarantees are made on the ordering.
*
* ```solidity
* contract Example {
* // Add the library methods
* using EnumerableSet for EnumerableSet.AddressSet;
*
* // Declare a set state variable
* EnumerableSet.AddressSet private mySet;
* }
* ```
*
* As of v3.3.0, sets of type `bytes32` (`Bytes32Set`), `address` (`AddressSet`)
* and `uint256` (`UintSet`) are supported.
*
* [WARNING]
* ====
* Trying to delete such a structure from storage will likely result in data corruption, rendering the structure
* unusable.
* See https://github.com/ethereum/solidity/pull/11843[ethereum/solidity#11843] for more info.
*
* In order to clean an EnumerableSet, you can either remove all elements one by one or create a fresh instance using an
* array of EnumerableSet.
* ====
*/
library EnumerableSet {
// To implement this library for multiple types with as little code
// repetition as possible, we write it in terms of a generic Set type with
// bytes32 values.
// The Set implementation uses private functions, and user-facing
// implementations (such as AddressSet) are just wrappers around the
// underlying Set.
// This means that we can only create new EnumerableSets for types that fit
// in bytes32.
struct Set {
// Storage of set values
bytes32[] _values;
// Position of the value in the `values` array, plus 1 because index 0
// means a value is not in the set.
mapping(bytes32 => uint256) _indexes;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function _add(Set storage set, bytes32 value) private returns (bool) {
if (!_contains(set, value)) {
set._values.push(value);
// The value is stored at length-1, but we add 1 to all indexes
// and use 0 as a sentinel value
set._indexes[value] = set._values.length;
return true;
} else {
return false;
}
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function _remove(Set storage set, bytes32 value) private returns (bool) {
// We read and store the value's index to prevent multiple reads from the same storage slot
uint256 valueIndex = set._indexes[value];
if (valueIndex != 0) {
// Equivalent to contains(set, value)
// To delete an element from the _values array in O(1), we swap the element to delete with the last one in
// the array, and then remove the last element (sometimes called as 'swap and pop').
// This modifies the order of the array, as noted in {at}.
uint256 toDeleteIndex = valueIndex - 1;
uint256 lastIndex = set._values.length - 1;
if (lastIndex != toDeleteIndex) {
bytes32 lastValue = set._values[lastIndex];
// Move the last value to the index where the value to delete is
set._values[toDeleteIndex] = lastValue;
// Update the index for the moved value
set._indexes[lastValue] = valueIndex; // Replace lastValue's index to valueIndex
}
// Delete the slot where the moved value was stored
set._values.pop();
// Delete the index for the deleted slot
delete set._indexes[value];
return true;
} else {
return false;
}
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function _contains(Set storage set, bytes32 value) private view returns (bool) {
return set._indexes[value] != 0;
}
/**
* @dev Returns the number of values on the set. O(1).
*/
function _length(Set storage set) private view returns (uint256) {
return set._values.length;
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function _at(Set storage set, uint256 index) private view returns (bytes32) {
return set._values[index];
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function _values(Set storage set) private view returns (bytes32[] memory) {
return set._values;
}
// Bytes32Set
struct Bytes32Set {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _add(set._inner, value);
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(Bytes32Set storage set, bytes32 value) internal returns (bool) {
return _remove(set._inner, value);
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(Bytes32Set storage set, bytes32 value) internal view returns (bool) {
return _contains(set._inner, value);
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(Bytes32Set storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(Bytes32Set storage set, uint256 index) internal view returns (bytes32) {
return _at(set._inner, index);
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(Bytes32Set storage set) internal view returns (bytes32[] memory) {
bytes32[] memory store = _values(set._inner);
bytes32[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// AddressSet
struct AddressSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(AddressSet storage set, address value) internal returns (bool) {
return _add(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(AddressSet storage set, address value) internal returns (bool) {
return _remove(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(AddressSet storage set, address value) internal view returns (bool) {
return _contains(set._inner, bytes32(uint256(uint160(value))));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(AddressSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(AddressSet storage set, uint256 index) internal view returns (address) {
return address(uint160(uint256(_at(set._inner, index))));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(AddressSet storage set) internal view returns (address[] memory) {
bytes32[] memory store = _values(set._inner);
address[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
// UintSet
struct UintSet {
Set _inner;
}
/**
* @dev Add a value to a set. O(1).
*
* Returns true if the value was added to the set, that is if it was not
* already present.
*/
function add(UintSet storage set, uint256 value) internal returns (bool) {
return _add(set._inner, bytes32(value));
}
/**
* @dev Removes a value from a set. O(1).
*
* Returns true if the value was removed from the set, that is if it was
* present.
*/
function remove(UintSet storage set, uint256 value) internal returns (bool) {
return _remove(set._inner, bytes32(value));
}
/**
* @dev Returns true if the value is in the set. O(1).
*/
function contains(UintSet storage set, uint256 value) internal view returns (bool) {
return _contains(set._inner, bytes32(value));
}
/**
* @dev Returns the number of values in the set. O(1).
*/
function length(UintSet storage set) internal view returns (uint256) {
return _length(set._inner);
}
/**
* @dev Returns the value stored at position `index` in the set. O(1).
*
* Note that there are no guarantees on the ordering of values inside the
* array, and it may change when more values are added or removed.
*
* Requirements:
*
* - `index` must be strictly less than {length}.
*/
function at(UintSet storage set, uint256 index) internal view returns (uint256) {
return uint256(_at(set._inner, index));
}
/**
* @dev Return the entire set in an array
*
* WARNING: This operation will copy the entire storage to memory, which can be quite expensive. This is designed
* to mostly be used by view accessors that are queried without any gas fees. Developers should keep in mind that
* this function has an unbounded cost, and using it as part of a state-changing function may render the function
* uncallable if the set grows to a point where copying to memory consumes too much gas to fit in a block.
*/
function values(UintSet storage set) internal view returns (uint256[] memory) {
bytes32[] memory store = _values(set._inner);
uint256[] memory result;
/// @solidity memory-safe-assembly
assembly {
result := store
}
return result;
}
}
HoldTime.sol 62 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
/**
* @dev Implementation of the contract HoldTime.
* It allows to update average hold time of the yield-bearing token.
*/
contract HoldTime is Ownable {
address public token;
mapping(address => uint256) private holdTimes;
event UpdateToken(address indexed token_);
event UpdateHoldTime(
address indexed account_,
uint256 oldHoldTime_,
uint256 newHoldTime_
);
/**
* @dev Update token.
* @param token_ token's address
* @notice Emits a {UpdateToken} event indicating the updated token `token_`.
*/
function updateToken(address token_) external onlyOwner {
require(token_ != address(0), "Every.finance: zero address");
require(token_ != token, "Every.finance: no change");
token = token_;
emit UpdateToken(token_);
}
/**
* @dev update HoldTimes.
* @param account_ account's address.
* @param amount_ token amount.
* Emits a {UpdateHoldTime} event with `account_`, `oldHoldTime_` and `newHoldTime_`.
*/
function updateHoldTime(address account_, uint256 amount_) external {
require(msg.sender == token, "Every.finance: caller is not token");
uint256 oldAmount_ = IERC20(token).balanceOf(account_);
uint256 oldHoldTime_ = holdTimes[account_];
uint256 newHoldTime_ = (oldAmount_ *
oldHoldTime_ +
block.timestamp *
amount_) / (oldAmount_ + amount_);
holdTimes[account_] = newHoldTime_;
emit UpdateHoldTime(account_, oldHoldTime_, newHoldTime_);
}
/**
* @dev get hold time.
* @param account_ investor's address.
* @return time_ hold time.
*/
function getHoldTime(address account_) public view returns (uint256 time_) {
time_ = holdTimes[account_];
}
}
Investment.sol 936 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
import "@chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol";
import "@openzeppelin/contracts/security/Pausable.sol";
import "../libraries/FeeMinter.sol";
import "./Management.sol";
import "./Proof.sol";
import "./Token.sol";
/**
* @dev Implementation of the contract Investment.
* It allows the investor to depositProof/withdraw funds and the manager to validate
* the depositProof/withdrawalProof investor requests.
*/
contract Investment is AccessControlEnumerable, Pausable {
using Math for uint256;
bytes32 public constant PROOF = keccak256("PROOF");
bytes32 public constant MANAGER = keccak256("MANAGER");
uint256 public constant MAX_PRICE = type(uint256).max;
uint256 public currentEventId;
uint256 public tokenPrice;
uint256 public tokenPriceMean;
uint256 public managementFeeLastTime;
uint256 public depositProofTokenId = 4;
uint256 public withdrawalProofTokenId;
uint256 public eventBatchSize;
uint256 public lastPerformanceFee;
uint256 public lastManagementFee;
uint256 public totalPerformanceFee;
uint256 public totalManagementFee;
address public asset;
Token public token;
Management public management;
Proof public depositProof;
Proof public withdrawalProof;
mapping(address => bool) public allowedAssetsForDeposit;
mapping(address => bool) public allowedAssetsForWithdrawal;
mapping(address => uint256) public totalDepositedAsset;
mapping(address => address) public oracles;
mapping(address => bool) public privateInvestors;
event UpdateManagement(address indexed management_);
event UpdateDepositProof(address indexed depositProof_);
event UpdateWithdrawalProof(address indexed withdrawalProof_);
event UpdateManagementParity(address indexed managementParity_);
event UpdateToken(address indexed token_);
event UpdateAsset(address indexed asset_);
event UpdateAssetForDeposit(address indexed asset_, bool state_);
event UpdateAssetForWithdrawal(address indexed asset_, bool state_);
event UpdateOracle(address indexed asset_, address Oracle_);
event UpdatePrivateInvestor(address indexed account_, bool state_);
event UpdateEventBatchSize(uint256 eventBatchSize_);
event DepositRequest(
address indexed account_,
address indexed asset_,
uint256 amount_
);
event CancelDepositRequest(
address indexed account_,
address indexed asset_,
uint256 amount_
);
event WithdrawalRequest(address indexed account_, uint256 amount_);
event CancelWithdrawalRequest(address indexed account_, uint256 amount_);
event StartNextEvent(uint256 tokenPrice, uint256 currentEventId);
event Validatedeposit(
uint256 indexed tokenId_,
uint256 validatedAmount_,
uint256 mintedAmount_
);
event Validatewithdrawal(
uint256 indexed tokenId_,
uint256 validatedAmount_,
uint256 SentAmount_
);
event MintPerformanceFee(uint256 performanceFee_);
event MintManagementFee(uint256 managementFee_);
event MintOrBurnInvestmentFee(
uint256 amount_,
bool isFee_,
uint256 remainingAmount_
);
constructor(
address token_,
address asset_,
address management_,
address depositProof_,
address withdrawalProof_,
address admin_
) payable {
require(token_ != address(0), "Every.finance: zero address");
require(management_ != address(0), "Every.finance: zero address");
require(depositProof_ != address(0), "Every.finance: zero address");
require(withdrawalProof_ != address(0), "Every.finance: zero address");
require(admin_ != address(0), "Every.finance: zero address");
token = Token(token_);
management = Management(management_);
depositProof = Proof(depositProof_);
withdrawalProof = Proof(withdrawalProof_);
if (asset_ != address(0)) {
(bool success_, uint8 assetDecimals_) = AssetTransfer
.tryGetAssetDecimals(IERC20(asset_));
require(success_, "Every.finance: no decimal");
require(assetDecimals_ <= uint8(18), "Every.finance: max decimal");
}
asset = asset_;
_setupRole(DEFAULT_ADMIN_ROLE, admin_);
_setupRole(PROOF, address(depositProof_));
_setupRole(PROOF, address(withdrawalProof_));
}
receive() external payable {}
/**
* @dev Update management.
* @param management_ management contract address
* Emits an {UpdateManagement} event indicating the updated management contract.
*/
function updateManagement(
address management_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(management_ != address(0), "Every.finance: zero address");
require(management_ != address(management), "Every.finance: no change");
management = Management(management_);
emit UpdateManagement(management_);
}
/**
* @dev Update depositProof.
* @param depositProof_ depositProof contract address
* Emits an {UpdateDepositProof} event indicating the updated depositProof contract.
*/
function updateDepositProof(
address depositProof_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(depositProof_ != address(0), "Every.finance: zero address");
require(
depositProof_ != address(depositProof),
"Every.finance: no change"
);
_revokeRole(PROOF, address(depositProof));
_grantRole(PROOF, depositProof_);
depositProof = Proof(depositProof_);
emit UpdateDepositProof(depositProof_);
}
/**
* @dev Update withdrawalProof.
* @param withdrawalProof_ withdrawalProof contract address
* Emits an {UpdateWithdrawalProof} event indicating the updated withdrawalProof contract.
*/
function updateWithdrawalProof(
address withdrawalProof_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(withdrawalProof_ != address(0), "Every.finance: zero address");
require(
withdrawalProof_ != address(withdrawalProof),
"Every.finance: no change"
);
_revokeRole(PROOF, address(withdrawalProof));
_grantRole(PROOF, withdrawalProof_);
withdrawalProof = Proof(withdrawalProof_);
emit UpdateWithdrawalProof(withdrawalProof_);
}
/**
* @dev Update the yield-bearing token address.
* @param token_ token's address.
* Emits an {UpdateToken} event indicating the updated token's address.
*/
function updateToken(address token_) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(token_ != address(0), "Every.finance: zero address");
require(token_ != address(token), "Every.finance: no change");
token = Token(token_);
emit UpdateToken(token_);
}
/**
* @dev Update the reference asset.
* @param asset_ asset's address.
* Emits an {UpdateAsset} event indicating the updated asset's address.
*/
function updateAsset(address asset_) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(asset_ != asset, "Every.finance: no change");
if (asset_ != address(0)) {
(bool success_, uint8 assetDecimals_) = AssetTransfer
.tryGetAssetDecimals(IERC20(asset_));
require(success_, "Every.finance: no decimal");
require(assetDecimals_ <= uint8(18), "Every.finance: max decimal");
}
asset = asset_;
emit UpdateAsset(asset_);
}
/**
* @dev Update the underlying asset that investors can deposit.
* @param asset_ asset's address.
* @param state_ true to add an asset and false to remove it.
* Emits an {UpdateAssetForDeposit} event indicating the updated asset `asset_`.
*/
function updateAssetForDeposit(
address asset_,
bool state_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
allowedAssetsForDeposit[asset_] = state_;
emit UpdateAssetForDeposit(asset_, state_);
}
/**
* @dev Update the underlying asset that investors can withdraw.
* @param asset_ asset's address.
* @param state_ true to add an asset and false to remove it.
* Emits an {UpdateAssetForWithdrawal} event indicating the updated asset `asset_`.
*/
function updateAssetForWithdrawal(
address asset_,
bool state_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
allowedAssetsForWithdrawal[asset_] = state_;
emit UpdateAssetForWithdrawal(asset_, state_);
}
/**
* @dev Update asset's oracle.
* @param asset_ asset's address.
* @param oracle_ asset's oracle.
* Emits an {UpdateOracle} event indicating the updated asset's oracle `oracle_`.
*/
function updateOracle(
address asset_,
address oracle_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
oracles[asset_] = oracle_;
emit UpdateOracle(asset_, oracle_);
}
/**
* @dev Update privateInvestors.
* @param account_ investor's address.
* @param state_ is true to add _account, false to remove it.
* Emits an {UpdatePrivateInvestor} event indicating `account_` and `state_`.
*/
function updatePrivateInvestor(
address account_,
bool state_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
privateInvestors[account_] = state_;
emit UpdatePrivateInvestor(account_, state_);
}
/**
* @dev Update eventBatchSize (maximum number of investors to be validate by batch).
* @param eventBatchSize_ new eventBatchSize number.
* Emits an {UpdateEventBatchSize} event indicating the updated eventBatchSize `eventBatchSize_`.
*/
function updateEventBatchSize(
uint256 eventBatchSize_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(eventBatchSize_ != 0, "Every.finance: zero value");
eventBatchSize = eventBatchSize_;
emit UpdateEventBatchSize(eventBatchSize_);
}
/**
* @dev Update ManagementFeeLastTime.
*/
function updateManagementFeeLastTime(
uint256 managementFeeLastTime_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
managementFeeLastTime = managementFeeLastTime_;
}
/**
* @dev Update TokenPriceMean.
*/
function updateTokenPriceMean(
uint256 tokenPriceMean_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
tokenPriceMean = tokenPriceMean_;
}
/**
* @dev start new event (manager cycle validation).
* Emits an {UpdateStartNextEvent} event with token price `tokenPrice` and next event id `currentEventId`.
*
*/
function startNextEvent() external onlyRole(MANAGER) {
(tokenPrice, ) = management.tokenPrice();
currentEventId += 1;
emit StartNextEvent(tokenPrice, currentEventId);
}
/**
* @dev validate investor deposit requests by the manager.
* The deposit request consists of minting the required amount of yield-bearing token for the investor, and
* decreasing his pending request amount by an equivalent amount.
* If the deposit request is fully validated (the pending request amount is zero), the corresponding proof is burned.
* @param tokenIds_ array of Proof tokens ids.
* @param maxdeposit_ max total amount of deposit asset to validate.
* Emits an {Validatedeposit} event with token id `tokenId_`, validate deposit asset amount
* `amountAsset_` and minted token amount `amountToken_`.
*/
function validateDeposits(
uint256[] calldata tokenIds_,
uint256 maxdeposit_
)
external
whenNotPaused
onlyRole(MANAGER)
returns (uint256 newMaxdeposit_)
{
require(tokenPrice != 0, "Every.finance: zero token price");
uint256 totalSupplyToken_ = token.totalSupply();
(
uint256 amountAssetTotal_,
uint256 amountTokenTotal_
) = _validateDeposits(tokenIds_, maxdeposit_);
unchecked {
newMaxdeposit_ = maxdeposit_ - amountAssetTotal_;
}
if (amountTokenTotal_ != 0) {
tokenPriceMean =
((totalSupplyToken_ * tokenPriceMean) +
(amountTokenTotal_ * tokenPrice)) /
(totalSupplyToken_ + amountTokenTotal_);
}
if (managementFeeLastTime == 0) {
managementFeeLastTime = block.timestamp;
}
}
/**
* @dev validate investor withdrawal requests by the manager.
* The deposit request consists of sending the required amount of asset to the investor, and
* burning the equivalent amount in yield-bearing token.
* If the withdrawal request is fully validated (the pending request amount is zero), the corresponding proof is burned.
* @param tokenIds_ array of Proof tokens ids.
* @param maxwithdrawal_ max total amount of withdrawal to validate.
* Emits an {ValidateWithdrawal} event with token id `tokenId_`, validate withdrawal asset amount
* `amountAsset_` and burned token amount `amountToken_`.
*/
function validateWithdrawals(
uint256[] calldata tokenIds_,
uint256 maxwithdrawal_
)
external
whenNotPaused
onlyRole(MANAGER)
returns (uint256 _newMaxwithdrawal)
{
require(tokenPrice != 0, "Every.finance: zero token price");
uint256 amountTokenTotal_ = _validateWithdrawals(
tokenIds_,
maxwithdrawal_
);
unchecked {
_newMaxwithdrawal = maxwithdrawal_ - amountTokenTotal_;
}
if ((amountTokenTotal_) != 0) {
token.burn(address(this), amountTokenTotal_);
}
}
/**
* @dev make a deposit request by the investor.
* the investor sends an amount of asset to the smart contracts and deposit fee to the treasury.
* the investor receives or updates his deposit Proof {ERC721}.
* @param account_ investor'address.
* @param asset_ asset'address.
* @param tokenId_ token id of the deposit Proof (if tokenId_ == 0, then a new token is minted).
* @param amount_ amount of asset to deposit.
* @param minPrice_ minimum price of yield-bearing token to be accepted.
* @param maxPrice_ maximum price of yield-bearing token to be accepted.
* @param maxFee_ maximum deposit fee to be accepted.
* Emits an {DepositRequest} event with account `account_` and amount `amount_`.
*/
function depositRequest(
address account_,
address asset_,
uint256 tokenId_,
uint256 amount_,
uint256 minPrice_,
uint256 maxPrice_,
uint256 maxFee_
) external payable whenNotPaused {
uint256 fee_;
require(amount_ != 0, "Every.finance: zero amount");
require(
allowedAssetsForDeposit[asset_],
"Every.finance: not allowed asset"
);
require(
amount_ >= getDepositMinAmount(asset_),
"Every.finance: min depositProof Amount"
);
uint256 totalDepositedAsset_ = totalDepositedAsset[asset_];
if (!privateInvestors[msg.sender]) {
fee_ = getDepositFee(asset_, amount_);
require(fee_ <= maxFee_, "Every.finance: max allowed fee");
amount_ -= fee_;
}
require(
totalDepositedAsset_ + amount_ <= management.assetCap(asset_),
"Every.finance: cap asset"
);
require(
(minPrice_ <= maxPrice_) && (maxPrice_ != 0),
"Every.finance: wrong prices"
);
totalDepositedAsset[asset_] = totalDepositedAsset_ + amount_;
if (tokenId_ == 0) {
depositProofTokenId += 1;
depositProof.mint(
account_,
asset_,
depositProofTokenId,
amount_,
minPrice_,
maxPrice_,
currentEventId
);
} else {
require(
depositProof.ownerOf(tokenId_) == account_,
"Every.finance: account is not owner"
);
(, , , , , address existedAsset_) = depositProof.pendingRequests(
tokenId_
);
require(
asset_ == existedAsset_,
"Every.finance: existing asset is different"
);
if (account_ != _msgSender()) {
(
,
,
uint256 minPriceOld_,
uint256 maxPriceOld_,
,
) = depositProof.pendingRequests(tokenId_);
require(
(minPrice_ == minPriceOld_) && (maxPrice_ == maxPriceOld_),
"Every.finance: prices don't match"
);
}
depositProof.increasePendingRequest(
tokenId_,
amount_,
minPrice_,
maxPrice_,
currentEventId,
asset_
);
}
if (asset_ != address(0)) {
AssetTransfer.transferFrom(
_msgSender(),
address(this),
amount_ + fee_,
IERC20(asset_)
);
} else {
require(
(msg.value == amount_ + fee_),
"Every.finance: no required amount"
);
}
if (fee_ > 0) {
AssetTransfer.transfer(management.treasury(), fee_, asset_);
}
emit DepositRequest(account_, asset_, amount_);
}
/**
* @dev cancel a deposit request by the investor.
* the investor can cancel a full or partial amount of his deposit.
* the investor burns or updates his deposit Proof {ERC721}.
* @param tokenId_ token id of the deposit Proof (if tokenId_ == 0, then a new token is minted).
* @param amount_ amount of asset to cancel.
* Emits an {CancelDepositRequest} event with the caller and amount `amount_`.
*/
function cancelDepositRequest(
uint256 tokenId_,
uint256 amount_
) external whenNotPaused {
require(
management.isCancelDeposit(),
"Every.finance: no deposit cancel"
);
require(amount_ != 0, "Every.finance: zero amount");
require(
depositProof.ownerOf(tokenId_) == _msgSender(),
"Every.finance: caller is not owner"
);
(, , , , , address asset_) = depositProof.pendingRequests(tokenId_);
totalDepositedAsset[asset_] -= amount_;
depositProof.decreasePendingRequest(
tokenId_,
amount_,
currentEventId,
asset_
);
AssetTransfer.transfer(_msgSender(), amount_, asset_);
emit CancelDepositRequest(_msgSender(), asset_, amount_);
}
/**
* @dev make a withdrawal request by the investor.
* the investor sends an amount of yield-bearing token to the smart contracts and withdrawal fee to the treasury.
* the investor receives or updates his withdrawal Proof {ERC721}.
* @param tokenId_ token id of the withdrawal Proof (if tokenId_ == 0, then a new token is minted).
* @param amount_ amount of yield-bearing token to withdraw.
* @param minPrice_ minimum price of yield-bearing token to be accepted.
* @param maxPrice_ maximum price of yield-bearing token to be accepted.
* @param maxFee_ maximum withdrawal fee to be accepted.
* Emits an {WithdrawalRequest} event with account `account_` and amount `amount_`.
*/
function withdrawalRequest(
uint256 tokenId_,
address asset_,
uint256 amount_,
uint256 minPrice_,
uint256 maxPrice_,
uint256 maxFee_
) external whenNotPaused {
require(amount_ != 0, "Every.finance: zero amount");
require(
allowedAssetsForWithdrawal[asset_],
"Every.finance: not allowed asset"
);
uint256 fee_;
require(
token.balanceOf(_msgSender()) >= amount_,
"Every.finance: amount exceeds balance"
);
if (!privateInvestors[msg.sender]) {
uint256 holdTime_ = token.getHoldTime(_msgSender());
if (management.isMinLockUpPeriod()) {
require(
block.timestamp - holdTime_ >= management.minLockUpPeriod(),
"Every.Finance: min lokup period"
);
}
fee_ =
(management.getWithdrawalFeeRate(holdTime_) * amount_) /
FeeMinter.SCALING_FACTOR_FEE;
require(fee_ <= maxFee_, "Every.finance: max allowed fee");
amount_ = amount_ - fee_;
}
require(
(minPrice_ <= maxPrice_) && (maxPrice_ != 0),
"Every.finance: wrong prices"
);
if (tokenId_ == 0) {
withdrawalProofTokenId += 1;
withdrawalProof.mint(
_msgSender(),
asset_,
withdrawalProofTokenId,
amount_,
minPrice_,
maxPrice_,
currentEventId
);
} else {
require(
withdrawalProof.ownerOf(tokenId_) == _msgSender(),
"Every.finance: caller is not owner"
);
(, , , , , address existedAsset_) = withdrawalProof.pendingRequests(
tokenId_
);
require(
asset_ == existedAsset_,
"Every.finance: existing asset is different"
);
withdrawalProof.increasePendingRequest(
tokenId_,
amount_,
minPrice_,
maxPrice_,
currentEventId,
asset_
);
}
token.transferFrom(_msgSender(), address(this), amount_);
if (fee_ != 0) {
token.transferFrom(_msgSender(), management.treasury(), fee_);
}
emit WithdrawalRequest(_msgSender(), amount_);
}
/**
* @dev cancel a withdrawal request by the investor.
* the investor can cancel a full or partial amount of his withdrawal.
* the investor burns or updates his withdrawal Proof {ERC721}.
* @param tokenId_ token id of the withdrawal Proof (if tokenId_ == 0, then a new token is minted).
* @param amount_ amount of yield-bearing token to cancel.
* Emits an {CancelWithdrawalRequest} event with the caller and amount `amount_`.
*/
function cancelWithdrawalRequest(
uint256 tokenId_,
uint256 amount_
) external whenNotPaused {
require(
management.isCancelWithdrawal(),
"Every.finance: no withdrawal cancel"
);
require(amount_ != 0, "Every.finance: zero amount");
require(
withdrawalProof.ownerOf(tokenId_) == _msgSender(),
"Every.finance: caller is not owner"
);
(, , , , , address asset_) = withdrawalProof.pendingRequests(tokenId_);
withdrawalProof.decreasePendingRequest(
tokenId_,
amount_,
currentEventId,
asset_
);
token.transfer(_msgSender(), amount_);
emit CancelWithdrawalRequest(_msgSender(), amount_);
}
/**
* @dev Send asset to the SafeHouse by the manager.
* @param amount_ amount to send.
* @param asset_ asset's address.
*/
function sendToSafeHouse(
uint256 amount_,
address asset_
) external whenNotPaused onlyRole(MANAGER) {
require(amount_ != 0, "Every.finance: zero amount");
address safeHouse_ = management.safeHouse();
require(safeHouse_ != address(0), "Every.finance: zero address");
AssetTransfer.transfer(safeHouse_, amount_, asset_);
}
/**
* @dev mint Performance fee by the manager
* performance fee are minted in yield-bearing token.
*/
function mintPerformanceFee() external onlyRole(MANAGER) {
(uint256 tokenPrice_, ) = management.tokenPrice();
uint256 performanceFeeRate_ = management.performanceFeeRate();
address treasury_ = management.treasury();
uint256 performanceFee_;
(tokenPriceMean, performanceFee_) = FeeMinter.mintPerformanceFee(
tokenPrice_,
tokenPriceMean,
performanceFeeRate_,
treasury_,
address(token)
);
lastPerformanceFee = performanceFee_;
totalPerformanceFee += performanceFee_;
emit MintPerformanceFee(performanceFee_);
}
/**
* @dev mint management fee by the manager
* management fee are minted in yield-bearing token.
*/
function mintManagementFee() external onlyRole(MANAGER) {
uint256 managementFeeRate_ = management.managementFeeRate();
address treasury_ = management.treasury();
uint256 managementFee_;
(managementFeeLastTime, managementFee_) = FeeMinter.mintManagementFee(
managementFeeLastTime,
managementFeeRate_,
treasury_,
address(token)
);
lastManagementFee = managementFee_;
totalManagementFee += managementFee_;
emit MintManagementFee(managementFee_);
}
/**
* @dev mint or burn Investment fee by the manager
* Investment fee are minted (negative fee) Or bunred (positive fee) in yield-bearing token.
* @param amount_ amount of negative/positive fee.
* @param isFee_ true if negative fee, false otherwise.
*/
function mintOrBurnInvestmentFee(
uint256 amount_,
bool isFee_
) external payable onlyRole(MANAGER) returns (uint256 remainingAmount_) {
(uint256 tokenPrice_, ) = management.tokenPrice();
address treasury_ = management.treasury();
remainingAmount_ = FeeMinter.MintInvestmentFee(
amount_,
tokenPrice_,
isFee_,
payable(treasury_),
address(token),
asset
);
emit MintOrBurnInvestmentFee(amount_, isFee_, remainingAmount_);
}
/**
* @dev get deposit fee for a deposit amount `amount_` of asset `asset_`
* @param asset_ asset's address to deposit by the investor.
* @param amount_ amount in asset to deposit by the investor.
*/
function getDepositFee(
address asset_,
uint256 amount_
) public view returns (uint256 fee_) {
(uint256 price_, uint256 decimal_) = getLatestPrice(asset_);
amount_ = (amount_ * price_) / 10 ** decimal_;
fee_ = management.getDepositFee(amount_);
fee_ = (fee_ * 10 ** decimal_) / price_;
return fee_;
}
/**
* @dev get yield-bearing token price.
*/
function getTokenPrice() public view returns (uint256 price_) {
(price_, ) = management.tokenPrice();
}
/**
* @dev get minimum deposit amount.
*/
function getDepositMinAmount(
address asset_
) public view returns (uint256 amount_) {
amount_ = management.minDepositAmount();
(uint256 price_, uint256 decimal_) = getLatestPrice(asset_);
amount_ = (amount_ * 10 ** decimal_) / price_;
}
/**
* @dev verify if the price bounds of deposit/withdrawal pending request are valid.
* @param proof_ Proof contract'address.
* @param tokenId_ token id of the pending request.
* @return isValid_ true if price bounds are valid , fase otherwise.
*/
function isValidPrice(
Proof proof_,
uint256 tokenId_
) public view returns (bool isValid_) {
(, , uint256 minPrice_, uint256 maxPrice_, , ) = proof_.pendingRequests(
tokenId_
);
isValid_ = (minPrice_ <= tokenPrice) && (maxPrice_ >= tokenPrice);
}
function getLatestPrice(
address asset_
) public view returns (uint256, uint256) {
address oracle_ = oracles[asset_];
AggregatorV3Interface priceFeed = AggregatorV3Interface(oracle_);
(
,
/*uint80 roundID*/ int price /*uint startedAt*/ /*uint timeStamp*/ /*uint80 answeredInRound*/,
,
,
) = priceFeed.latestRoundData();
require(price > 0, "Every.finance: invalid price");
uint8 decimals_ = priceFeed.decimals();
return (uint256(price), decimals_);
}
function _validateDeposits(
uint256[] calldata tokenIds_,
uint256 maxdeposit_
) internal returns (uint256 amountAssetTotal_, uint256 amountTokenTotal_) {
uint256 amountAsset_;
uint256 amountToken_;
uint256 price_;
uint256 decimal_;
uint256 size_ = tokenIds_.length;
address owner_;
address asset_;
require(size_ != 0, "Every.finance: size is zero");
require(size_ <= eventBatchSize, "Every.finance: max size");
for (uint256 i = 0; i < size_; ) {
owner_ = depositProof.ownerOf(tokenIds_[i]);
require(owner_ != address(0), "Every.finance: zero address");
if (!isValidPrice(depositProof, tokenIds_[i])) {
depositProof.updateEventId(tokenIds_[i], currentEventId);
} else {
if (maxdeposit_ <= amountAssetTotal_) {
break;
}
depositProof.preValidatePendingRequest(
tokenIds_[i],
currentEventId
);
(amountAsset_, , , , , asset_) = depositProof.pendingRequests(
tokenIds_[i]
);
(price_, decimal_) = getLatestPrice(asset_);
amountAsset_ = Math.mulDiv(
amountAsset_,
price_,
10 ** decimal_
);
amountAsset_ = Math.min(
maxdeposit_ - amountAssetTotal_,
amountAsset_
);
unchecked {
amountAssetTotal_ += amountAsset_;
}
amountToken_ = Math.mulDiv(
amountAsset_,
FeeMinter.SCALING_FACTOR_PRICE,
tokenPrice
);
if (amountToken_ != 0) {
token.mint(owner_, amountToken_);
amountTokenTotal_ += amountToken_;
}
amountAsset_ = Math.mulDiv(
amountAsset_,
10 ** decimal_,
price_
);
depositProof.validatePendingRequest(
tokenIds_[i],
amountAsset_,
currentEventId,
asset_
);
emit Validatedeposit(tokenIds_[i], amountAsset_, amountToken_);
}
unchecked {
i++;
}
}
}
function _validateWithdrawals(
uint256[] calldata tokenIds_,
uint256 maxwithdrawal_
) internal returns (uint256 amountTokenTotal_) {
uint256 amountToken_;
uint256 amountAsset_;
uint256 size_ = tokenIds_.length;
uint256 tokenId_;
address owner_;
address asset_;
uint256 price_;
uint256 decimal_;
require(size_ != 0, "Every.finance: size is zero");
require(size_ <= eventBatchSize, "Every.finance: max size");
uint256 amountTotal_ = withdrawalProof.totalAmount();
for (uint256 i = 0; i < size_; ) {
tokenId_ = tokenIds_[i];
owner_ = withdrawalProof.ownerOf(tokenId_);
require(owner_ != address(0), "Every.finance: zero address");
if (!isValidPrice(withdrawalProof, tokenId_)) {
withdrawalProof.updateEventId(tokenId_, currentEventId);
} else {
withdrawalProof.preValidatePendingRequest(
tokenId_,
currentEventId
);
(amountToken_, , , , , asset_) = withdrawalProof
.pendingRequests(tokenId_);
amountToken_ = Math.min(
Math.mulDiv(maxwithdrawal_, amountToken_, amountTotal_),
amountToken_
);
unchecked {
amountTokenTotal_ += amountToken_;
}
withdrawalProof.validatePendingRequest(
tokenId_,
amountToken_,
currentEventId,
asset_
);
amountAsset_ = Math.mulDiv(
amountToken_,
tokenPrice,
FeeMinter.SCALING_FACTOR_PRICE
);
(price_, decimal_) = getLatestPrice(asset_);
amountAsset_ = Math.mulDiv(
amountAsset_,
10 ** decimal_,
price_
);
if (amountAsset_ != 0) {
AssetTransfer.transfer(owner_, amountAsset_, asset_);
}
emit Validatewithdrawal(tokenId_, amountToken_, amountAsset_);
}
unchecked {
i++;
}
}
}
function pause() public onlyRole(DEFAULT_ADMIN_ROLE) {
_pause();
}
function unpause() public onlyRole(DEFAULT_ADMIN_ROLE) {
_unpause();
}
}
Management.sol 424 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
import "@openzeppelin/contracts/utils/math/Math.sol";
/**
* @dev Implementation of the contract Management.
* It allows the manager to set the different parameters of the product.
*/
contract Management is AccessControlEnumerable {
bytes32 public constant MANAGER = keccak256("MANAGER");
bytes32 public constant ORACLE = keccak256("ORACLE");
uint256 public constant SCALING_FACTOR = 1e8;
struct Fee {
uint256 rate;
uint256 time;
}
struct Price {
uint256 value;
uint256 time;
}
struct DepositFee {
uint256 rate;
uint256 minValue;
uint256 maxValue;
}
uint256 public managementFeeRate;
uint256 public performanceFeeRate;
uint256 public minDepositAmount;
uint256 public minLockUpPeriod;
Price public tokenPrice;
DepositFee public depositFee;
Fee[] public withdrawalFee;
bool public isCancelDeposit;
bool public isCancelWithdrawal;
bool public isMinLockUpPeriod;
address public treasury;
address public safeHouse;
mapping(address => uint256) public assetCap;
event UpdateTreasury(address indexed treasury_);
event UpdateSafeHouse(address indexed safeHouse_);
event UpdateIsCancelDeposit(bool iscancelDeposit_);
event UpdateIsCancelWithdrawal(bool isWithdrawalCancel_);
event UpdateIsMinLockUpPeriod(bool isMinLockUpPeriod_);
event UpdateMinLockUpPeriod(uint256 minLockUpPeriod_);
event UpdateDepositFee(uint256 rate_, uint256 minValue_, uint256 maxValue_);
event UpdateManagementFeeRate(uint256 managementFeeRate_);
event UpdatePerformanceFeeRate(uint256 performanceFeeRate_);
event UpdateMinDepositAmount(uint256 minDepositAmount_);
event UpdateTokenPrice(Price price_);
event AddWithdrawalFee(uint256 rate_, uint256 time_);
event UpdateWithdrawalFee(uint256 index_, uint256 rate_, uint256 time_);
event DeleteLastWithdrawalFee(uint256 rate_, uint256 time_);
event UpdateAssetCap(address indexed asset_, uint256 cap_);
constructor(address admin_, address manager_, address treasury_) {
require(admin_ != address(0), "Every.finance: zero address");
require(manager_ != address(0), "Every.finance: zero address");
require(treasury_ != address(0), "Every.finance: zero address");
treasury = treasury_;
_setupRole(DEFAULT_ADMIN_ROLE, admin_);
_setupRole(MANAGER, manager_);
}
/**
* @dev Update treasury.
* @param treasury_.
* Emits an {UpdateTreasury} event indicating the updated treasury `treasury_`.
*/
function updateTreasury(
address treasury_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(treasury_ != address(0), "Every.finance: zero address");
require(treasury != treasury_, "Every.finance: no change");
treasury = treasury_;
emit UpdateTreasury(treasury_);
}
/**
* @dev Update safeHouse.
* @param safeHouse_.
* Emits an {UpdateSafeHouse} event indicating the updated safeHouse `safeHouse_`.
*/
function updateSafeHouse(
address safeHouse_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(safeHouse_ != address(0), "Every.finance: zero address");
require(safeHouse != safeHouse_, "Every.finance: no change");
safeHouse = safeHouse_;
emit UpdateSafeHouse(safeHouse_);
}
/**
* @dev Update isCancelDeposit.
* @param isCancelDeposit_.
* Emits an {UpdateIsCancelDeposit} event indicating the updated isCancelDeposit ` isCancelDeposit_`.
*/
function updateIsCancelDeposit(
bool isCancelDeposit_
) external onlyRole(MANAGER) {
require(
isCancelDeposit_ != isCancelDeposit,
"Every.finance: no change"
);
isCancelDeposit = isCancelDeposit_;
emit UpdateIsCancelDeposit(isCancelDeposit_);
}
/**
* @dev Update isCancelWithdrawal.
* @param isCancelWithdrawal_.
* Emits an {UpdateIsCancelWithdrawal} event indicating the updated isCancelWithdrawal ` isCancelWithdrawal_`.
*/
function updateIsCancelWithdrawal(
bool isCancelWithdrawal_
) external onlyRole(MANAGER) {
require(
isCancelWithdrawal_ != isCancelWithdrawal,
"Every.finance: no change"
);
isCancelWithdrawal = isCancelWithdrawal_;
emit UpdateIsCancelWithdrawal(isCancelWithdrawal_);
}
/**
* @dev Update isMinLockUpPeriod.
* @param isMinLockUpPeriod_.
* Emits an {UpdateIsMinLockUpPeriod} event indicating the updated isMinLockUpPeriod ` isMinLockUpPeriod_`.
*/
function updateIsMinLockUpPeriod(
bool isMinLockUpPeriod_
) external onlyRole(MANAGER) {
require(
isMinLockUpPeriod_ != isMinLockUpPeriod,
"Every.finance: no change"
);
isMinLockUpPeriod = isMinLockUpPeriod_;
emit UpdateIsMinLockUpPeriod(isMinLockUpPeriod_);
}
/**
* @dev Update minLockUpPeriod.
* @param minLockUpPeriod_ minimum locked up period
* Emits an {UpdateMinLockUpPeriod_} event indicating the updated minLockUpPeriod_ `minLockUpPeriod_`
* and max value `maxValue_`
*/
function updateMinLockUpPeriod(
uint256 minLockUpPeriod_
) external onlyRole(MANAGER) {
minLockUpPeriod = minLockUpPeriod_;
emit UpdateMinLockUpPeriod(minLockUpPeriod_);
}
/**
* @dev Update depositFee.
* @param rate_.
* @param minValue_.
* @param maxValue_.
* Emits an {UpdateDepositFee} event indicating the updated rate `rate_`, min value `minValue_`
* and max value `maxValue_`
*/
function updateDepositFee(
uint256 rate_,
uint256 minValue_,
uint256 maxValue_
) external onlyRole(MANAGER) {
require(rate_ <= SCALING_FACTOR, "Every.finance: out of range");
require(minValue_ <= maxValue_, "Every.finance: wrong min max values");
depositFee = DepositFee(rate_, minValue_, maxValue_);
emit UpdateDepositFee(rate_, minValue_, maxValue_);
}
/**
* @dev Update managementFeeRate.
* @param managementFeeRate_.
* Emits an {UpdateManagementFeeRate} event indicating the updated managementFeeRate `managementFeeRate_`.
*/
function updateManagementFeeRate(
uint256 managementFeeRate_
) external onlyRole(MANAGER) {
require(
managementFeeRate_ <= SCALING_FACTOR,
"Every.finance: out of range"
);
managementFeeRate = managementFeeRate_;
emit UpdateManagementFeeRate(managementFeeRate_);
}
/**
* @dev Update performanceFeeRate.
* @param performanceFeeRate_.
* Emits an {UpdatePerformanceFeeRate} event indicating the updated performanceFeeRate `performanceFeeRate_`.
*/
function updatePerformanceFeeRate(
uint256 performanceFeeRate_
) external onlyRole(MANAGER) {
require(
performanceFeeRate_ <= SCALING_FACTOR,
"Every.finance: out of range"
);
performanceFeeRate = performanceFeeRate_;
emit UpdatePerformanceFeeRate(performanceFeeRate_);
}
/**
* @dev Update MinDepositAmount.
* @param minDepositAmount_.
* Emits an {UpdateMinDepositAmount} event indicating the updated minDepositAmount `minDepositAmount_`.
*/
function updateMinDepositAmount(
uint256 minDepositAmount_
) external onlyRole(MANAGER) {
require(
depositFee.minValue <= minDepositAmount_,
"Every.finance: lower than min deposit fee"
);
minDepositAmount = minDepositAmount_;
emit UpdateMinDepositAmount(minDepositAmount_);
}
/**
* @dev Update tokenPrice.
* @param price_.
* Emits an {UpdateTokenPrice} event indicating the updated tokenPrice.
*/
function updateTokenPrice(uint256 price_) external onlyRole(ORACLE) {
require(price_ != 0, "Every.finance: zero price");
tokenPrice = Price(price_, block.timestamp);
emit UpdateTokenPrice(tokenPrice);
}
/**
* @dev add a new withdrawal fee.
* @param rate_.
* @param time_.
* Emits an {AddWithdrawalFee} event with feeRate `rate_` and feePeriod `time_`.
*/
function addWithdrawalFee(
uint256 rate_,
uint256 time_
) external onlyRole(MANAGER) {
require(rate_ <= SCALING_FACTOR, "Every.finance: out of range");
uint256 size_ = withdrawalFee.length;
if (size_ != 0) {
require(
withdrawalFee[size_ - 1].time < time_,
"Every.finance: times don't match"
);
require(
withdrawalFee[size_ - 1].rate > rate_,
"Every.finance: fee rates don't match"
);
}
withdrawalFee.push(Fee(rate_, time_));
emit AddWithdrawalFee(rate_, time_);
}
/**
* @dev Update withdrawal fee.
* @param index_ index of array withdrawalFee to be updated.
* @param rate_ new fee.
* @param time_ new period.
* Emits an {UpdateWithdrawalFee} event with `index_`, `rate_`, and 'time_'.
*/
function updateWithdrawalFee(
uint256 index_,
uint256 rate_,
uint256 time_
) external onlyRole(MANAGER) {
require(rate_ <= SCALING_FACTOR, "Every.finance: out of range");
uint256 size_ = withdrawalFee.length;
require(index_ < size_, "Every.finance: out of size");
if (index_ != 0) {
require(
withdrawalFee[index_ - 1].time < time_,
"Every.finance: times don't match"
);
require(
withdrawalFee[index_ - 1].rate > rate_,
"Every.finance: fee rates don't match"
);
}
if (index_ < size_ - 1) {
require(
withdrawalFee[index_ + 1].time > time_,
"Every.finance: times don't match"
);
require(
withdrawalFee[index_ + 1].rate < rate_,
"Every.finance: fee rates don't match"
);
}
withdrawalFee[index_] = Fee(rate_, time_);
emit UpdateWithdrawalFee(index_, rate_, time_);
}
/**
* @dev delete last fee from withdrawalFee.
* Emits an {DeleteLastWithdrawalFee} event with the removed fee.
*/
function deleteLastWithdrawalFee() external onlyRole(MANAGER) {
uint256 size_ = withdrawalFee.length;
require(size_ != 0, "Every.finance. array is empty");
Fee memory fee_ = withdrawalFee[size_ - 1];
withdrawalFee.pop();
emit DeleteLastWithdrawalFee(fee_.rate, fee_.time);
}
/**
* @dev calculate withdrawal fee rate.
* @param holdTime_ hold time of the yield-bearing tokens.
*/
function calculateWithdrawalFeeRate(
uint256 holdTime_
) public view returns (uint256) {
uint256 size_ = withdrawalFee.length;
require(block.timestamp >= holdTime_, "Every.finance: max time");
uint256 deltaTime_;
unchecked {
deltaTime_ = block.timestamp - holdTime_;
}
if (size_ == 0) {
return 0;
} else if (deltaTime_ <= withdrawalFee[0].time) {
return withdrawalFee[0].rate;
} else if (deltaTime_ > withdrawalFee[size_ - 1].time) {
return 0;
} else {
uint256 time_;
Fee memory fee_;
for (uint256 i = 0; i < size_ - 1; ) {
time_ = withdrawalFee[i].time;
fee_ = withdrawalFee[i + 1];
if ((deltaTime_ > time_) && (deltaTime_ <= fee_.time)) {
return fee_.rate;
}
unchecked {
i++;
}
}
return 0;
}
}
/**
* @dev Update asset's cap.
* @param asset_ asset's cap.
* @param cap_ asset's cap.
* Emits an {UpdateAssetCap} event indicating the updated asset's cap `cap_`.
*/
function updateAssetCap(
address asset_,
uint256 cap_
) external onlyRole(MANAGER) {
assetCap[asset_] = cap_;
emit UpdateAssetCap(asset_, cap_);
}
/**
* @dev get deposit fee.
* @param amount_ deposit amount.
* @return fee_ deposit fee.
*/
function getDepositFee(uint256 amount_) public view returns (uint256 fee_) {
DepositFee memory depositFee_ = depositFee;
fee_ = Math.max(
Math.mulDiv(depositFee_.rate, amount_, SCALING_FACTOR),
depositFee_.minValue
);
fee_ = Math.min(fee_, depositFee_.maxValue);
}
/**
* @dev get token price.
*/
function getTokenPrice() public view returns (Price memory) {
return tokenPrice;
}
/**
* @dev get withdrawal fee rate.
* @param holdTime_ hold time of the yield-bearing tokens.
* @return feeRate_ withdrawal fee rate.
*/
function getWithdrawalFeeRate(
uint256 holdTime_
) public view returns (uint256 feeRate_) {
feeRate_ = calculateWithdrawalFeeRate(holdTime_);
}
/**
* @dev get withdrawal fee.
* @param index_ index of array withdrawal fee.
* @return fee_ withdrawal fee.
*/
function getWithdrawalFee(
uint256 index_
) public view returns (Fee memory fee_) {
require(index_ < withdrawalFee.length, "Every.finance. out of size");
fee_ = withdrawalFee[index_];
}
/**
* @dev get withdrawalFee size.
*/
function getWithdrawalFeeSize() public view returns (uint256) {
return withdrawalFee.length;
}
}
Proof.sol 407 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol";
import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/Strings.sol";
import "../libraries/PendingRequest.sol";
import "../interfaces/IMetadata.sol";
/**
* @dev Implementation of the investor's proof token {ERC721}.
* We distinguish between deposit proof token and withdrawal proof token.
* The investor receives the deposit/withdrawal proof token when he makes his deposit/withdrawal
* request, waiting to be validated by the manager.
*/
contract Proof is ERC721Enumerable, Ownable, AccessControlEnumerable {
using Strings for uint256;
using PendingRequest for PendingRequestData;
bytes32 public constant INVESTMENT = keccak256("INVESTMENT");
uint256 public constant TOLERANCE_MAX = 1000; // To handel rounding errors
uint256 public tolerance;
uint8 public immutable id;
bool public isOnChainMetadata;
string public baseURI;
address public investment;
uint256 public totalAmount;
mapping(uint256 => PendingRequestData) public pendingRequests;
mapping(uint256 => uint256) public pendingIdIndex;
mapping(address => uint256) public totalAmountPerAsset;
uint256[] public pendingIds;
IMetadata public metadata;
event UpdateInvestment(address indexed investment_);
event UpdateMetadata(address indexed metadata_);
event UpdateBaseURI(string baseURI_);
event UpdateTolerance(uint256 tolerance_);
event UpdateIsOnChainMetadata(bool isOnChainMetadata_);
event Mint(address indexed account_, uint256 tokenId_, uint256 amount_);
event Burn(uint256 tokenId_);
constructor(
string memory name_,
string memory symbol_,
uint8 id_,
address admin_
) ERC721(name_, symbol_) {
require(id_ <= 1, "Every.finance: out of range");
require(admin_ != address(0), "Every.finance: zero address");
id = id_;
_setupRole(DEFAULT_ADMIN_ROLE, admin_);
}
/**
* @dev get the size of array pendingIds.
*/
function getPendingIdsSize() public view returns (uint256) {
return pendingIds.length;
}
/**
* @dev Update investment.
* @param investment_.
* Emits an {UpdateInvestment} event indicating the updated investment `investment_`.
*/
function updateInvestment(
address investment_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(investment_ != address(0), "Every.finance: zero address");
require(investment_ != investment, "Every.finance: no change");
_revokeRole(INVESTMENT, investment);
_grantRole(INVESTMENT, investment_);
investment = investment_;
emit UpdateInvestment(investment_);
}
/**
* @dev Update metadata.
* @param metadata_.
* Emits an {UpdateMetadata} event indicating the updated metadata `metadata_`.
*/
function updateMetadata(
address metadata_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(metadata_ != address(0), "Every.finance: zero address");
require(metadata_ != address(metadata), "Every.finance: no change");
metadata = IMetadata(metadata_);
emit UpdateMetadata(metadata_);
}
/**
* @dev Update baseURI.
* @param uri_ new baseURI.
* Emits an {UpdateBaseURI} event indicating the updated baseURI `uri_`.
*/
function setBaseURI(
string calldata uri_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
baseURI = uri_;
emit UpdateBaseURI(uri_);
}
/**
* @dev Update tolerance.
* @param tolerance_.
* Emits an {UpdateTolerance} event indicating the updated tolerance `tolerance_`.
*/
function updateTolerance(
uint256 tolerance_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(tolerance_ <= TOLERANCE_MAX, "Every.finance: tolerance max");
require(tolerance_ != tolerance, "Every.finance: no change");
tolerance = tolerance_;
emit UpdateTolerance(tolerance_);
}
/**
* @dev Update isOnChainMetadata.
* @param isOnChainMetadata_.
* Emits an {UpdateIsOnChainMetadata} event indicating the updated isOnChainMetadata `isOnChainMetadata_`.
*/
function updateIsOnChainMetadata(
bool isOnChainMetadata_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(
isOnChainMetadata != isOnChainMetadata_,
"Every.finance: no change"
);
isOnChainMetadata = isOnChainMetadata_;
emit UpdateIsOnChainMetadata(isOnChainMetadata_);
}
/**
* @dev mint a Proof token.
* The investor receives a proof Token when he makes
* a deposit/withdrawal request.
* @param account_ investor's address.
* @param asset_ asset's address.
* @param tokenId_ id of the token.
* @param amount_ amount to mint.
* @param minPrice_ minimum price of the yield-bearing token.
* @param maxPrice_ maximum price of the yield-bearing token
* @param currentEventId_ id of the next manager event (process).
* Emits an {Mint} event with `account_`, `tokenId_`, and `amount`.
*/
function mint(
address account_,
address asset_,
uint256 tokenId_,
uint256 amount_,
uint256 minPrice_,
uint256 maxPrice_,
uint256 currentEventId_
) external onlyRole(INVESTMENT) {
_safeMint(account_, tokenId_);
pendingIds.push(tokenId_);
pendingIdIndex[tokenId_] = pendingIds.length - 1;
_increasePendingRequest(
tokenId_,
amount_,
minPrice_,
maxPrice_,
currentEventId_,
asset_
);
pendingRequests[tokenId_].asset = asset_;
emit Mint(account_, tokenId_, amount_);
}
/**
* @dev increase the pending request balance of token `tokenId_` by `amount`.
* @param tokenId_ id of the token.
* @param amount_ amount to add.
* @param minPrice_ minimum price of the yield-bearing token.
* @param maxPrice_ maximum price of the yield-bearing token
* @param currentEventId_ id of the next manager event (process).
* @param asset_ asset's address.
*/
function increasePendingRequest(
uint256 tokenId_,
uint256 amount_,
uint256 minPrice_,
uint256 maxPrice_,
uint256 currentEventId_,
address asset_
) external onlyRole(INVESTMENT) {
_increasePendingRequest(
tokenId_,
amount_,
minPrice_,
maxPrice_,
currentEventId_,
asset_
);
}
/**
* @dev decrease the pending request balance of token `tokenId_` by `amount`.
* @param tokenId_ id of the token.
* @param amount_ amount to remove.
* @param currentEventId_ id of the next manager event (process).
* @param asset_ asset's address.
*/
function decreasePendingRequest(
uint256 tokenId_,
uint256 amount_,
uint256 currentEventId_,
address asset_
) external onlyRole(INVESTMENT) {
_decreasePendingRequest(tokenId_, amount_, currentEventId_, asset_);
}
/**
* @dev update event Id
* @param tokenId_ id of the token.
* @param currentEventId_ current event Id.
*/
function updateEventId(
uint256 tokenId_,
uint256 currentEventId_
) external onlyRole(INVESTMENT) {
pendingRequests[tokenId_].updateEventId(currentEventId_);
}
/**
* @dev update the locked and available pending balances before the manager validation.
* @param tokenId_ id of the token.
* @param currentEventId_ id of the next manager event (process).
*/
function preValidatePendingRequest(
uint256 tokenId_,
uint256 currentEventId_
) external onlyRole(INVESTMENT) {
pendingRequests[tokenId_].preValidate(currentEventId_);
}
/**
* @dev update the locked pending balance after the manager validation.
* @param tokenId_ id of the token.
* @param amount_ amount to remove from the locked pending balance.
* @param currentEventId_ id of the next manager event (process).
* @param asset_ asset's address.
*/
function validatePendingRequest(
uint256 tokenId_,
uint256 amount_,
uint256 currentEventId_,
address asset_
) external onlyRole(INVESTMENT) {
pendingRequests[tokenId_].validate(amount_, currentEventId_);
_decreasetotalAmountPerAsset(tokenId_, amount_, asset_);
}
/**
* @dev get tokenURI of token `tokenId`.
* If `isOnChainMetadata`, the token metadata is generated on chain.
* Otherwise, see {IERC721Metadata-tokenURI}.
* @param tokenId token id .
*/
function tokenURI(
uint256 tokenId
) public view virtual override returns (string memory) {
_requireMinted(tokenId);
if (isOnChainMetadata) {
return metadata.render(tokenId);
} else {
string memory string_ = _baseURI();
return
bytes(string_).length > 0
? string(abi.encodePacked(string_, tokenId.toString()))
: "";
}
}
/**
* @dev See {IERC165-supportsInterface}.
*/
function supportsInterface(
bytes4 interfaceId
)
public
view
override(ERC721Enumerable, AccessControlEnumerable)
returns (bool)
{
return
ERC721Enumerable.supportsInterface(interfaceId) ||
AccessControlEnumerable.supportsInterface(interfaceId);
}
/**
* @dev increase the pending request balance of token `tokenId_` by `amount`.
* This internal function is called when an investor makes a deposit/withdrawal request.
* @param tokenId_ id of the token.
* @param amount_ amount to add.
* @param minPrice_ minimum price of the yield-bearing token.
* @param maxPrice_ maximum price of the yield-bearing token
* @param currentEventId_ id of the next manager event (process).
* @param asset_ asset's address.
*/
function _increasePendingRequest(
uint256 tokenId_,
uint256 amount_,
uint256 minPrice_,
uint256 maxPrice_,
uint256 currentEventId_,
address asset_
) internal {
pendingRequests[tokenId_].increase(
amount_,
minPrice_,
maxPrice_,
currentEventId_
);
totalAmountPerAsset[asset_] += amount_;
if (id == 0) {
totalAmount += amount_;
}
}
/**
* @dev decrease the pending request balance of token `tokenId_` by `amount`.
* This internal function is called when an investor cancel a deposit/withdrawal request.
* @param tokenId_ id of the token.
* @param amount_ amount to remove.
* @param currentEventId_ id of the next manager event (process).
* @param asset_ asset's address.
*/
function _decreasePendingRequest(
uint256 tokenId_,
uint256 amount_,
uint256 currentEventId_,
address asset_
) internal {
pendingRequests[tokenId_].decrease(amount_, currentEventId_);
_decreasetotalAmountPerAsset(tokenId_, amount_, asset_);
}
/**
* @dev burn token `tokenId_.
* a proof token is burned when its corresponding investor pending request is fully validated by the manager.
* @param tokenId_ id of the token.
* Emits a {Burn} event with `owner_` and `tokenId_ `.
*/
function burn(uint256 tokenId_) internal {
_burn(tokenId_);
_deleteId(tokenId_);
emit Burn(tokenId_);
}
function _deleteId(uint256 id_) internal {
uint256 index_ = pendingIdIndex[id_];
uint256 lastId_ = pendingIds[pendingIds.length - 1];
pendingIds[index_] = lastId_;
pendingIds.pop();
pendingIdIndex[lastId_] = index_;
delete pendingIdIndex[id_];
delete pendingRequests[id_];
}
/**
* @dev decrease totalAmountPerAsset at least by `amount`.
* This internal function decreases totalAmountPerAsset at least by `amount` when an investor cancels his
* deposit/withdrawal request `tokenId_` or the manager validates it.
* If the remaining pending request balance of `tokenId_` is lower than `tolerance`,
* the proof token `tokenId_` is burned and this remaining balance amount is removed also from totalAmountPerAsset.
* @param tokenId_ id of the token.
* @param amount_ amount of asset.
* @param asset_ asset's address.
*/
function _decreasetotalAmountPerAsset(
uint256 tokenId_,
uint256 amount_,
address asset_
) internal {
uint256 amountToRemove_ = amount_;
uint256 remainingAmount_ = pendingRequests[tokenId_].lockedAmount +
pendingRequests[tokenId_].availableAmount;
if (remainingAmount_ <= tolerance) {
amountToRemove_ += remainingAmount_;
burn(tokenId_);
}
require(
totalAmountPerAsset[asset_] >= amountToRemove_,
"Every.finance: max amount"
);
unchecked {
totalAmountPerAsset[asset_] -= amountToRemove_;
}
if (id == 0) {
unchecked {
totalAmount -= amountToRemove_;
}
}
}
function _baseURI() internal view override returns (string memory) {
return baseURI;
}
}
Token.sol 161 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
import "./HoldTime.sol";
/**
* @dev Implementation of the yield-bearing tokens {ERC20}.
*/
contract Token is ERC20, AccessControlEnumerable {
bytes32 public constant INVESTMENT = keccak256("INVESTMENT");
address public investment;
mapping(address => bool) public whitelist;
HoldTime public holdTime;
event UpdateInvestment(address indexed investment_);
event UpdateHoldTime(address indexed holdTime_);
event AddToWhiteList(address indexed address_);
event RemoveFromWhiteList(address indexed address_);
event Mint(address indexed to_, uint256 amount_);
event Burn(address indexed account_, uint256 amount_);
constructor(
string memory _name,
string memory _symbol,
address holdTime_,
address admin_
) ERC20(_name, _symbol) {
require(holdTime_ != address(0), "Every.finance: zero address");
require(admin_ != address(0), "Every.finance: zero address");
_setupRole(DEFAULT_ADMIN_ROLE, admin_);
holdTime = HoldTime(holdTime_);
}
/**
* @dev Update investment.
* @param investment_.
* Emits an {UpdateInvestment} event indicating the updated investment `investment_`.
*/
function updateInvestment(
address investment_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(investment_ != address(0), "Every.finance: zero address");
require(investment_ != investment, "Every.finance: no change");
_revokeRole(INVESTMENT, investment);
_grantRole(INVESTMENT, investment_);
whitelist[investment] = false;
whitelist[investment_] = true;
investment = investment_;
emit UpdateInvestment(investment_);
}
/**
* @dev Update holdTime.
* @param holdTime_.
* Emits an {UpdateHoldTime} event indicating the updated holdTime `holdTime_`.
*/
function updateHoldTime(
address holdTime_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(holdTime_ != address(0), "Every.finance: zero address");
require(holdTime_ != address(holdTime), "Every.finance: no change");
holdTime = HoldTime(holdTime_);
emit UpdateHoldTime(holdTime_);
}
/**
* @dev Add `account_` to `whitelist `.
* @param account_ .
* Emits an {AddToWhiteList} event indicating the addedd address `account_`.
*/
function addToWhiteList(
address account_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(account_ != address(0), "Every.finance: zero address");
require(!whitelist[account_], "Every.finance: address exists");
whitelist[account_] = true;
emit AddToWhiteList(account_);
}
/**
* @dev remove `account_` from `whitelist `.
* @param account_ .
* Emits an {RemoveFromWhiteList} event indicating the deleted address `account_`.
*/
function removeFromWhiteList(
address account_
) external onlyRole(DEFAULT_ADMIN_ROLE) {
require(whitelist[account_], "Every.finance: address doesn't exist");
whitelist[account_] = false;
emit RemoveFromWhiteList(account_);
}
/**
* @dev mint `amount_`Token for `to_`
* @param to_ receiver's address.
* @param amount_ amount to mint.
* Emits an {Mint} event with `to_`, and `amount_`.
*/
function mint(address to_, uint256 amount_) external onlyRole(INVESTMENT) {
_mint(to_, amount_);
emit Mint(to_, amount_);
}
/**
* @dev burn `amount_`Token for `from_`
* @param from_ user's address.
* @param amount_ amount to burn.
* Emits an {Burn} event with `from_`, and `amount_`.
*/
function burn(
address from_,
uint256 amount_
) external onlyRole(INVESTMENT) {
require(amount_ != 0, "Every.finance: zero amount");
_burn(from_, amount_);
emit Burn(from_, amount_);
}
/**
* @dev get the average token hold time of `account_`
* @param account_ user's address.
* @return time_ average token hold time.
*/
function getHoldTime(address account_) public view returns (uint256 time_) {
time_ = holdTime.getHoldTime(account_);
}
/**
* @dev update the average token hold time for `account_`.
* @param account_ user's address.
* @param amount_ new received token amount.
*/
function _updateHoldTime(address account_, uint256 amount_) internal {
require(amount_ != 0, "Every.finance: zero amount");
holdTime.updateHoldTime(account_, amount_);
}
/**
* @dev Hook that is called before any transfer of tokens. This includes
* minting and burning. It permits to update the hold time of the receiver `to_` if :
* - the receiver's address `from_` is not zero nor whitelisted and the sender is not whitelisted
* @param from sender's address.
* @param to receiver's address.
* @param amount transferred amount.
*/
function _beforeTokenTransfer(
address from,
address to,
uint256 amount
) internal virtual override {
if ((to != address(0)) && (!whitelist[from]) && (!whitelist[to])) {
_updateHoldTime(to, amount);
}
}
}
Treasury.sol 40 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/access/AccessControlEnumerable.sol";
import "../libraries/AssetTransfer.sol";
/**
* @author Every.finance.
* @notice Implementation of Treasury contract.
*/
contract Treasury is AccessControlEnumerable {
bytes32 public constant WITHDRAWER = keccak256("WITHDRAWER");
event SendTo(address indexed to_, uint256 amount_, address asset_);
constructor(address admin_) payable {
_setupRole(DEFAULT_ADMIN_ROLE, admin_);
}
receive() external payable {}
/**
* @dev Send asset `asset_` from the contract to address `to_`.
* @param to_ receiver.
* @param amount_ amount to send.
* @param asset_ asset's address.
* Emits an {SendTo} event with `to_`, `amount_` and `asset_`.
*/
function sendTo(
address to_,
uint256 amount_,
address asset_
) public onlyRole(WITHDRAWER) {
require(to_ != address(0), "Every.finance: zero address");
AssetTransfer.transfer(to_, amount_, asset_);
emit SendTo(to_, amount_, asset_);
}
}
IMetadata.sol 6 lines
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
interface IMetadata {
function render(uint256 _tokenId) external view returns (string memory);
}
AssetTransfer.sol 84 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
import "@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol";
/**
* @dev Implementation of the library AssetTransfer that proposes functions to transfer Ether/ERC20 asset.
*/
library AssetTransfer {
using SafeERC20 for IERC20;
/**
* @dev transfer `amount_` of asset `asset_` from `from_` to `to_`.
* @param from_ sender'address.
* @param to_ receiver'address.
* @param amount_ amount to send.
* @param asset_ asset's IERC20 interface to send.Its decimal has to be lower than 18,
* if it is ERC20.
*/
function transferFrom(
address from_,
address to_,
uint256 amount_,
IERC20 asset_
) internal {
(bool success_, uint8 assetDecimals_) = tryGetAssetDecimals(asset_);
require(success_, "Every.finance: no decimal");
require(assetDecimals_ <= uint8(18), "Every.finance: max decimal");
unchecked {
assetDecimals_ = uint8(18) - assetDecimals_;
}
amount_ = amount_ / 10 ** assetDecimals_;
require(amount_ != 0, "Every.finance: zero amount");
asset_.safeTransferFrom(from_, to_, amount_);
}
/**
* @dev transfer `amount_` of asset `asset_` to `to_`.
* @param to_ receiver'address.
* @param amount_ amount to send.
* @param asset_ asset's address to send. Its decimal has to be lower than 18,
* if it is ERC20.
*/
function transfer(address to_, uint256 amount_, address asset_) internal {
if (asset_ != address(0)) {
(bool success_, uint8 assetDecimals_) = tryGetAssetDecimals(
IERC20(asset_)
);
require(success_, "Every.finance: no decimal");
assetDecimals_ = uint8(18) - assetDecimals_;
amount_ = amount_ / 10 ** assetDecimals_;
require(amount_ != 0, "Every.finance: zero amount");
IERC20(asset_).safeTransfer(to_, amount_);
} else {
require(
address(this).balance >= amount_,
"Every.finance: amount exceeds balance"
);
payable(to_).transfer(amount_);
}
}
/**
* @dev get asset's decimal.
* @param asset_ asset's IERC20 interface.
*/
function tryGetAssetDecimals(
IERC20 asset_
) internal view returns (bool, uint8) {
(bool success, bytes memory encodedDecimals) = address(asset_)
.staticcall(
abi.encodeWithSelector(IERC20Metadata.decimals.selector)
);
if (success && encodedDecimals.length >= 32) {
uint256 returnedDecimals = abi.decode(encodedDecimals, (uint256));
if (returnedDecimals <= type(uint8).max) {
return (true, uint8(returnedDecimals));
}
}
return (false, 0);
}
}
FeeMinter.sol 239 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
import "@openzeppelin/contracts/utils/math/Math.sol";
import "./AssetTransfer.sol";
import "../common/Treasury.sol";
import "../common/Token.sol";
/**
* @dev Implementation of the library FeeMinter that proposes functions to calculate and mint different fee.
*/
library FeeMinter {
uint256 public constant SCALING_FACTOR_FEE = 1e8;
uint256 public constant SCALING_FACTOR_PRICE = 1e18;
uint256 public constant SECONDES_PER_YEAR = 365 days;
/**
* @dev calculate and mint performance fee.
* performance fee is generated when the current price is above the average price.
* Performance fee is minted in yield-bearing token for the treasury.
* @param tokenPrice_ current price of the yield-bearing token.
* @param tokenPriceMean_ average price of the yield-bearing token.
* @param performanceFeeRate_ performance fee rate. Its precision factor is SCALING_FACTOR.
* @param treasury_ treasury
* @param token_ yield-bearing token's address.
*/
function mintPerformanceFee(
uint256 tokenPrice_,
uint256 tokenPriceMean_,
uint256 performanceFeeRate_,
address treasury_,
address token_
) internal returns (uint256, uint256) {
Token tokenERC20_ = Token(token_);
uint256 performanceFee_;
if (tokenPrice_ > tokenPriceMean_) {
uint256 deltaPrice_;
unchecked {
deltaPrice_ = tokenPrice_ - tokenPriceMean_;
tokenPriceMean_ = tokenPrice_;
}
performanceFee_ = Math.mulDiv(
tokenERC20_.totalSupply(),
(deltaPrice_ * performanceFeeRate_),
(tokenPrice_ * SCALING_FACTOR_FEE)
);
tokenERC20_.mint(treasury_, performanceFee_);
}
return (tokenPriceMean_, performanceFee_);
}
/**
* @dev calculate and mint management fee.
* management fee is minted in yield-bearing token for the treasury.
* @param managementFeeLastTime_ last time at wich the management fee is calculated.
* @param managementFeeRate_ management fee rate. Its precision factor is SCALING_FACTOR.
* @param treasury_ treasury
* @param token_ yield-bearing token's address.
*/
function mintManagementFee(
uint256 managementFeeLastTime_,
uint256 managementFeeRate_,
address treasury_,
address token_
) internal returns (uint256, uint256) {
uint256 managementFee_;
if (managementFeeLastTime_ != 0) {
Token tokenERC20_ = Token(token_);
uint256 deltaTime_ = block.timestamp - managementFeeLastTime_;
managementFee_ = Math.mulDiv(
tokenERC20_.totalSupply(),
(managementFeeRate_ * deltaTime_),
(SCALING_FACTOR_FEE * SECONDES_PER_YEAR)
);
managementFeeLastTime_ = block.timestamp;
tokenERC20_.mint(treasury_, managementFee_);
}
return (managementFeeLastTime_, managementFee_);
}
/**
* @dev calculate and mint investment fee (ie. slippage fee)
* investment fee is minted in yield-bearing token for the treasury.
* investment fee can be negative (cost: isFee == true) or positive (profit: isFee == false).
* if investment fee is negative, the manager can verify if he can get from the treasury the underlying asset ,
* and mint for it the equivalent amount in yield-bearing token.
* if investment fee is positive, the manager can verify if he can send to the treasury the underlying asset ,
* and burn form it the equivalent amount in yield-bearing token.
* @param amount_ amount of fee in yield-bearing token.
* @param tokenPrice_ current token price.
* @param isFee_ true if positive fee, false otherwise.
* @param treasury_ treasury
* @param token_ yield-bearing token's address.
* @param asset_ asset's address.
*/
function MintInvestmentFee(
uint256 amount_,
uint256 tokenPrice_,
bool isFee_,
address payable treasury_,
address token_,
address asset_
) internal returns (uint256) {
require(amount_ != 0, "Every.finance: zero amount");
uint256 assetBalanceTreasury_ = _getBalance(asset_, treasury_);
uint256 tokenBalanceTreasury_ = IERC20(token_).balanceOf(treasury_);
if (isFee_) {
return
_mintNegativeInvestmentFee(
amount_,
assetBalanceTreasury_,
tokenPrice_,
treasury_,
address(token_),
asset_
);
} else {
return
_burnPositiveInvestmentFee(
amount_,
tokenBalanceTreasury_,
tokenPrice_,
treasury_,
address(token_),
asset_
);
}
}
/**
* @dev get asset's balance of the treasury.
* @param asset_ asset's addres.
* @param treasury_ treasury
*/
function _getBalance(
address asset_,
address treasury_
) internal view returns (uint256 balance_) {
if (asset_ == address(0)) {
balance_ = treasury_.balance;
} else {
balance_ = IERC20(asset_).balanceOf(treasury_);
(bool success_, uint8 assetDecimals_) = AssetTransfer
.tryGetAssetDecimals(IERC20(asset_));
require(success_, "Every.finance: no decimal");
require(assetDecimals_ <= uint8(18), "Every.finance: max decimal");
unchecked {
assetDecimals_ = uint8(18) - assetDecimals_;
}
balance_ = balance_ * 10 ** assetDecimals_;
}
}
/**
* @dev calculate and mint negative investment fee (ie. slippage fee)
* investment fee is minted in yield-bearing token for the treasury.
* the function verifies if it's possible to get from the treasury the underlying asset ,
* and mint for it the equivalent amount in yield-bearing token.
* @param amount_ amount of fee in yield-bearing token.
* @param assetBalanceTreasury_ asset's balance of the treasury.
* @param tokenPrice_ current token price.
* @param treasury_ treasury
* @param token_ yield-bearing token's address.
* @param asset_ asset's address.
*/
function _mintNegativeInvestmentFee(
uint256 amount_,
uint256 assetBalanceTreasury_,
uint256 tokenPrice_,
address payable treasury_,
address token_,
address asset_
) internal returns (uint256 remainingAmount_) {
uint256 deltaAmount_ = Math.min(amount_, assetBalanceTreasury_);
if (deltaAmount_ != 0) {
Token tokenERC20_ = Token(token_);
Treasury(treasury_).sendTo(address(this), deltaAmount_, asset_);
uint256 tokenAmount_ = Math.mulDiv(
deltaAmount_,
SCALING_FACTOR_PRICE,
tokenPrice_
);
tokenERC20_.mint(treasury_, tokenAmount_);
unchecked {
remainingAmount_ = amount_ - deltaAmount_;
}
} else {
remainingAmount_ = amount_;
}
}
/**
* @dev calculate and burn positive investment fee (ie. slippage fee)
* investment fee is burned in yield-bearing token from the treasury.
* the function verifies if it's possible to send to the treasury the underlying asset ,
* and burn from it the equivalent amount in yield-bearing token.
* @param amount_ amount of fee in yield-bearing token.
* @param tokenBalanceTreasury_ yield-bearing token's balance of the treasury.
* @param tokenPrice_ current token price.
* @param treasury_ treasury
* @param token_ yield-bearing token's address.
* @param asset_ asset's address.
*/
function _burnPositiveInvestmentFee(
uint256 amount_,
uint256 tokenBalanceTreasury_,
uint256 tokenPrice_,
address treasury_,
address token_,
address asset_
) internal returns (uint256 remainingAmount_) {
uint256 tokenAmount_ = Math.mulDiv(
amount_,
SCALING_FACTOR_PRICE,
tokenPrice_
);
tokenAmount_ = Math.min(tokenAmount_, tokenBalanceTreasury_);
uint256 deltaAmount_;
if (tokenAmount_ != 0) {
Token tokenERC20_ = Token(token_);
deltaAmount_ = Math.mulDiv(
tokenAmount_,
tokenPrice_,
SCALING_FACTOR_PRICE
);
AssetTransfer.transfer(treasury_, deltaAmount_, asset_);
tokenERC20_.burn(treasury_, tokenAmount_);
}
unchecked {
remainingAmount_ = amount_ - deltaAmount_;
}
}
}
PendingRequest.sol 142 lines
// SPDX-License-Identifier: MIT
// Every.finance Contracts
pragma solidity ^0.8.4;
struct PendingRequestData {
uint256 lockedAmount;
uint256 availableAmount;
uint256 minPrice;
uint256 maxPrice;
uint256 eventId;
address asset;
}
/**
* @dev Implementation of the library PendingRequest that proposes functions to update for an investor a struct PendingRequestData.
*/
library PendingRequest {
/**
* @dev Modifier that checks if the new price bounds are valid.
* It reverts when introducing new price bounds during a manager event validation.
* It prevents the investor to modify the price bounds of his deposit/withdrawal request
* during a manager event validation.
*/
modifier CheckPrice(
PendingRequestData storage request,
uint256 minPrice_,
uint256 maxPrice_,
uint256 currentEventId_
) {
if ((request.minPrice != 0) || (request.maxPrice != 0)) {
if (currentEventId_ > request.eventId) {
require(
(minPrice_ == request.minPrice) &&
(maxPrice_ == request.maxPrice),
"Every.finance: price don't match"
);
}
}
_;
}
/**
* @dev Modifier that update for an investor his pending request data
* to be synchronized with the current event id.
*/
modifier syncWithEventId(
PendingRequestData storage request,
uint256 currentEventId_
) {
if (currentEventId_ > request.eventId) {
request.lockedAmount += request.availableAmount;
request.availableAmount = 0;
request.eventId = currentEventId_;
}
_;
}
/**
* @dev increase a pending request `request` by `amount`.
* This function is called when an investor makes a deposit/withdrawal request.
* @param request pending request.
* @param amount_ amount to add.
* @param minPrice_ minimum price of the yield-bearing token.
* @param maxPrice_ maximum price of the yield-bearing token
* @param currentEventId_ id of the next manager event (process).
*/
function increase(
PendingRequestData storage request,
uint256 amount_,
uint256 minPrice_,
uint256 maxPrice_,
uint256 currentEventId_
)
internal
CheckPrice(request, minPrice_, maxPrice_, currentEventId_)
syncWithEventId(request, currentEventId_)
{
request.availableAmount += amount_;
request.minPrice = minPrice_;
request.maxPrice = maxPrice_;
}
/**
* @dev decrease a pending request `request` by `amount`.
* This function is called when an investor cancels a deposit/withdrawal request.
* @param request pending request.
* @param amount_ amount to remove.
* @param currentEventId_ id of the next manager event (process).
*/
function decrease(
PendingRequestData storage request,
uint256 amount_,
uint256 currentEventId_
) internal syncWithEventId(request, currentEventId_) {
require(
request.availableAmount >= amount_,
"Every.finance: max amount"
);
unchecked {
request.availableAmount -= amount_;
}
}
/**
* @dev update event Id
*
* @param request pending request.
* @param currentEventId_ id of the next manager event (process).
*/
function updateEventId(
PendingRequestData storage request,
uint256 currentEventId_
) internal {
request.eventId = currentEventId_;
}
/**
* @dev update the locked and available pending balances of `request` before the manager validation.
* @param request pending request.
* @param currentEventId_ id of the next manager event (process).
*/
function preValidate(
PendingRequestData storage request,
uint256 currentEventId_
) internal syncWithEventId(request, currentEventId_) {}
/**
* @dev decrease the locked pending balance of `request` after the manager validation by `amount`.
* @param request pending request.
* @param currentEventId_ id of the next manager event (process).
*/
function validate(
PendingRequestData storage request,
uint256 amount_,
uint256 currentEventId_
) internal syncWithEventId(request, currentEventId_) {
require(request.lockedAmount >= amount_, "Every.finance: max amount");
unchecked {
request.lockedAmount -= amount_;
}
}
}
InvestmentSigmaSOL.sol 19 lines
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;
import "../common/Investment.sol";
/**
* @author Every.finance.
* @notice Implementation of the contract InvestmentSigmaSOL.
*/
contract InvestmentSigmaSOL is Investment {
constructor(
address token_,
address asset_,
address management_,
address deposit_,
address withdrawal_,
address admin_
) Investment(token_, asset, management_, deposit_, withdrawal_, admin_) {}
}
Read Contract
DEFAULT_ADMIN_ROLE 0xa217fddf → bytes32
MANAGER 0x1b2df850 → bytes32
MAX_PRICE 0x01c11d96 → uint256
PROOF 0x1e46e4d3 → bytes32
allowedAssetsForDeposit 0x1acf0809 → bool
allowedAssetsForWithdrawal 0x6fb60d7c → bool
asset 0x38d52e0f → address
currentEventId 0x091dbbd7 → uint256
depositProof 0x9522c9a1 → address
depositProofTokenId 0xef600be2 → uint256
eventBatchSize 0xde0d5421 → uint256
getDepositFee 0xa7825373 → uint256
getDepositMinAmount 0x7fbb4ead → uint256
getLatestPrice 0x16345f18 → uint256, uint256
getRoleAdmin 0x248a9ca3 → bytes32
getRoleMember 0x9010d07c → address
getRoleMemberCount 0xca15c873 → uint256
getTokenPrice 0x4b94f50e → uint256
hasRole 0x91d14854 → bool
isValidPrice 0x7e8af985 → bool
lastManagementFee 0x0823f628 → uint256
lastPerformanceFee 0x918c2f80 → uint256
management 0x88a8d602 → address
managementFeeLastTime 0x03cfbc1d → uint256
oracles 0xaddd5099 → address
paused 0x5c975abb → bool
privateInvestors 0xaadee89c → bool
supportsInterface 0x01ffc9a7 → bool
token 0xfc0c546a → address
tokenPrice 0x7ff9b596 → uint256
tokenPriceMean 0xf9892d14 → uint256
totalDepositedAsset 0x4c790bea → uint256
totalManagementFee 0xbf95c57a → uint256
totalPerformanceFee 0xaa6f29df → uint256
withdrawalProof 0x22725866 → address
withdrawalProofTokenId 0x30745c0c → uint256
Write Contract 28 functions
These functions modify contract state and require a wallet transaction to execute.
cancelDepositRequest 0xca43aa0f
uint256 tokenId_
uint256 amount_
cancelWithdrawalRequest 0x61f8b102
uint256 tokenId_
uint256 amount_
depositRequest 0x8a874966
address account_
address asset_
uint256 tokenId_
uint256 amount_
uint256 minPrice_
uint256 maxPrice_
uint256 maxFee_
grantRole 0x2f2ff15d
bytes32 role
address account
mintManagementFee 0x5ded9321
No parameters
mintOrBurnInvestmentFee 0xaa363779
uint256 amount_
bool isFee_
returns: uint256
mintPerformanceFee 0x00465331
No parameters
pause 0x8456cb59
No parameters
renounceRole 0x36568abe
bytes32 role
address account
revokeRole 0xd547741f
bytes32 role
address account
sendToSafeHouse 0x1ee61004
uint256 amount_
address asset_
startNextEvent 0x18ad5949
No parameters
unpause 0x3f4ba83a
No parameters
updateAsset 0xf141b52b
address asset_
updateAssetForDeposit 0x0e46c73b
address asset_
bool state_
updateAssetForWithdrawal 0x68ee5e7f
address asset_
bool state_
updateDepositProof 0x1ec83156
address depositProof_
updateEventBatchSize 0xe6894a9f
uint256 eventBatchSize_
updateManagement 0x7193ec17
address management_
updateManagementFeeLastTime 0xe5b5cf9f
uint256 managementFeeLastTime_
updateOracle 0x83d998ae
address asset_
address oracle_
updatePrivateInvestor 0xd499bb35
address account_
bool state_
updateToken 0x7ad3def2
address token_
updateTokenPriceMean 0x1930840f
uint256 tokenPriceMean_
updateWithdrawalProof 0x2b899c74
address withdrawalProof_
validateDeposits 0x4e9f55b6
uint256[] tokenIds_
uint256 maxdeposit_
returns: uint256
validateWithdrawals 0xc356c880
uint256[] tokenIds_
uint256 maxwithdrawal_
returns: uint256
withdrawalRequest 0x4031b91c
uint256 tokenId_
address asset_
uint256 amount_
uint256 minPrice_
uint256 maxPrice_
uint256 maxFee_
Token Balances (1)
View Transfers →Recent Transactions
No transactions found for this address