1316 lines
60 KiB
TypeScript
Generated
1316 lines
60 KiB
TypeScript
Generated
// tslint:disable:no-consecutive-blank-lines ordered-imports align trailing-comma
|
|
// tslint:disable:whitespace no-unbound-method no-trailing-whitespace
|
|
// tslint:disable:no-unused-variable
|
|
import {
|
|
BaseContract,
|
|
EventCallback,
|
|
IndexedFilterValues,
|
|
SubscriptionManager,
|
|
PromiseWithTransactionHash,
|
|
} from '@0x/base-contract';
|
|
import { schemas } from '@0x/json-schemas';
|
|
import {
|
|
BlockParam,
|
|
BlockParamLiteral,
|
|
BlockRange,
|
|
CallData,
|
|
ContractAbi,
|
|
ContractArtifact,
|
|
DecodedLogArgs,
|
|
LogWithDecodedArgs,
|
|
MethodAbi,
|
|
TransactionReceiptWithDecodedLogs,
|
|
TxData,
|
|
TxDataPayable,
|
|
SupportedProvider,
|
|
} from 'ethereum-types';
|
|
import { BigNumber, classUtils, logUtils, providerUtils } from '@0x/utils';
|
|
import { SimpleContractArtifact } from '@0x/types';
|
|
import { Web3Wrapper } from '@0x/web3-wrapper';
|
|
import { assert } from '@0x/assert';
|
|
import * as ethers from 'ethers';
|
|
// tslint:enable:no-unused-variable
|
|
|
|
export type ERC20TokenEventArgs = ERC20TokenTransferEventArgs | ERC20TokenApprovalEventArgs;
|
|
|
|
export enum ERC20TokenEvents {
|
|
Transfer = 'Transfer',
|
|
Approval = 'Approval',
|
|
}
|
|
|
|
export interface ERC20TokenTransferEventArgs extends DecodedLogArgs {
|
|
_from: string;
|
|
_to: string;
|
|
_value: BigNumber;
|
|
}
|
|
|
|
export interface ERC20TokenApprovalEventArgs extends DecodedLogArgs {
|
|
_owner: string;
|
|
_spender: string;
|
|
_value: BigNumber;
|
|
}
|
|
|
|
/* istanbul ignore next */
|
|
// tslint:disable:no-parameter-reassignment
|
|
// tslint:disable-next-line:class-name
|
|
export class ERC20TokenContract extends BaseContract {
|
|
public static deployedBytecode =
|
|
'0x608060405234801561001057600080fd5b50600436106100725760003560e01c806370a082311161005057806370a0823114610121578063a9059cbb14610154578063dd62ed3e1461018d57610072565b8063095ea7b31461007757806318160ddd146100c457806323b872dd146100de575b600080fd5b6100b06004803603604081101561008d57600080fd5b5073ffffffffffffffffffffffffffffffffffffffff81351690602001356101c8565b604080519115158252519081900360200190f35b6100cc61023b565b60408051918252519081900360200190f35b6100b0600480360360608110156100f457600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135610241565b6100cc6004803603602081101561013757600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661049d565b6100b06004803603604081101561016a57600080fd5b5073ffffffffffffffffffffffffffffffffffffffff81351690602001356104c5565b6100cc600480360360408110156101a357600080fd5b5073ffffffffffffffffffffffffffffffffffffffff81358116916020013516610652565b33600081815260016020908152604080832073ffffffffffffffffffffffffffffffffffffffff8716808552908352818420869055815186815291519394909390927f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925928290030190a350600192915050565b60025490565b73ffffffffffffffffffffffffffffffffffffffff83166000908152602081905260408120548211156102d557604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f45524332305f494e53554646494349454e545f42414c414e4345000000000000604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8416600090815260016020908152604080832033845290915290205482111561037457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601c60248201527f45524332305f494e53554646494349454e545f414c4c4f57414e434500000000604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8316600090815260208190526040902054828101101561040a57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601060248201527f55494e543235365f4f564552464c4f5700000000000000000000000000000000604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff80841660008181526020818152604080832080548801905593881680835284832080548890039055600182528483203384528252918490208054879003905583518681529351929391927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef9281900390910190a35060019392505050565b73ffffffffffffffffffffffffffffffffffffffff1660009081526020819052604090205490565b3360009081526020819052604081205482111561054357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601a60248201527f45524332305f494e53554646494349454e545f42414c414e4345000000000000604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff831660009081526020819052604090205482810110156105d957604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601060248201527f55494e543235365f4f564552464c4f5700000000000000000000000000000000604482015290519081900360640190fd5b336000818152602081815260408083208054879003905573ffffffffffffffffffffffffffffffffffffffff871680845292819020805487019055805186815290519293927fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef929181900390910190a350600192915050565b73ffffffffffffffffffffffffffffffffffffffff91821660009081526001602090815260408083209390941682529190915220549056fea265627a7a7231582053ae9d35bb9db1df3465a7d6eaf05e122dc38e959647dd6bcfb63cdace0be3e464736f6c634300050b0032';
|
|
/**
|
|
* `msg.sender` approves `_spender` to spend `_value` tokens
|
|
*/
|
|
public approve = {
|
|
/**
|
|
* Sends an Ethereum transaction executing this method with the supplied parameters. This is a read/write
|
|
* Ethereum operation and will cost gas.
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @param _value The amount of wei to be approved for transfer
|
|
* @param txData Additional data for transaction
|
|
* @returns The hash of the transaction
|
|
*/
|
|
async sendTransactionAsync(
|
|
_spender: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<string> {
|
|
assert.isString('_spender', _spender);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('approve(address,uint256)', [
|
|
_spender.toLowerCase(),
|
|
_value,
|
|
]);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...txData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
if (txDataWithDefaults.from !== undefined) {
|
|
txDataWithDefaults.from = txDataWithDefaults.from.toLowerCase();
|
|
}
|
|
|
|
const txHash = await self._web3Wrapper.sendTransactionAsync(txDataWithDefaults);
|
|
return txHash;
|
|
},
|
|
/**
|
|
* Sends an Ethereum transaction and waits until the transaction has been successfully mined without reverting.
|
|
* If the transaction was mined, but reverted, an error is thrown.
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @param _value The amount of wei to be approved for transfer
|
|
* @param txData Additional data for transaction
|
|
* @param pollingIntervalMs Interval at which to poll for success
|
|
* @returns A promise that resolves when the transaction is successful
|
|
*/
|
|
awaitTransactionSuccessAsync(
|
|
_spender: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData>,
|
|
pollingIntervalMs?: number,
|
|
timeoutMs?: number,
|
|
): PromiseWithTransactionHash<TransactionReceiptWithDecodedLogs> {
|
|
assert.isString('_spender', _spender);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const txHashPromise = self.approve.sendTransactionAsync(_spender.toLowerCase(), _value, txData);
|
|
return new PromiseWithTransactionHash<TransactionReceiptWithDecodedLogs>(
|
|
txHashPromise,
|
|
(async (): Promise<TransactionReceiptWithDecodedLogs> => {
|
|
// When the transaction hash resolves, wait for it to be mined.
|
|
return self._web3Wrapper.awaitTransactionSuccessAsync(
|
|
await txHashPromise,
|
|
pollingIntervalMs,
|
|
timeoutMs,
|
|
);
|
|
})(),
|
|
);
|
|
},
|
|
/**
|
|
* Estimates the gas cost of sending an Ethereum transaction calling this method with these arguments.
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @param _value The amount of wei to be approved for transfer
|
|
* @param txData Additional data for transaction
|
|
* @returns The hash of the transaction
|
|
*/
|
|
async estimateGasAsync(
|
|
_spender: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<number> {
|
|
assert.isString('_spender', _spender);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('approve(address,uint256)', [
|
|
_spender.toLowerCase(),
|
|
_value,
|
|
]);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...txData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
if (txDataWithDefaults.from !== undefined) {
|
|
txDataWithDefaults.from = txDataWithDefaults.from.toLowerCase();
|
|
}
|
|
|
|
const gas = await self._web3Wrapper.estimateGasAsync(txDataWithDefaults);
|
|
return gas;
|
|
},
|
|
async validateAndSendTransactionAsync(
|
|
_spender: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<string> {
|
|
await (this as any).approve.callAsync(_spender, _value, txData);
|
|
const txHash = await (this as any).approve.sendTransactionAsync(_spender, _value, txData);
|
|
return txHash;
|
|
},
|
|
/**
|
|
* Sends a read-only call to the contract method. Returns the result that would happen if one were to send an
|
|
* Ethereum transaction to this method, given the current state of the blockchain. Calls do not cost gas
|
|
* since they don't modify state.
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @param _value The amount of wei to be approved for transfer
|
|
* @returns Always true if the call has enough gas to complete execution
|
|
*/
|
|
async callAsync(
|
|
_spender: string,
|
|
_value: BigNumber,
|
|
callData: Partial<CallData> = {},
|
|
defaultBlock?: BlockParam,
|
|
): Promise<boolean> {
|
|
assert.isString('_spender', _spender);
|
|
assert.isBigNumber('_value', _value);
|
|
assert.doesConformToSchema('callData', callData, schemas.callDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (defaultBlock !== undefined) {
|
|
assert.isBlockParam('defaultBlock', defaultBlock);
|
|
}
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('approve(address,uint256)', [
|
|
_spender.toLowerCase(),
|
|
_value,
|
|
]);
|
|
const callDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...callData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
callDataWithDefaults.from = callDataWithDefaults.from
|
|
? callDataWithDefaults.from.toLowerCase()
|
|
: callDataWithDefaults.from;
|
|
let rawCallResult;
|
|
try {
|
|
rawCallResult = await self._web3Wrapper.callAsync(callDataWithDefaults, defaultBlock);
|
|
} catch (err) {
|
|
BaseContract._throwIfThrownErrorIsRevertError(err);
|
|
throw err;
|
|
}
|
|
BaseContract._throwIfCallResultIsRevertError(rawCallResult);
|
|
const abiEncoder = self._lookupAbiEncoder('approve(address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const result = abiEncoder.strictDecodeReturnValue<boolean>(rawCallResult);
|
|
// tslint:enable boolean-naming
|
|
return result;
|
|
},
|
|
/**
|
|
* Returns the ABI encoded transaction data needed to send an Ethereum transaction calling this method. Before
|
|
* sending the Ethereum tx, this encoded tx data can first be sent to a separate signing service or can be used
|
|
* to create a 0x transaction (see protocol spec for more details).
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @param _value The amount of wei to be approved for transfer
|
|
* @returns The ABI encoded transaction data as a string
|
|
*/
|
|
getABIEncodedTransactionData(_spender: string, _value: BigNumber): string {
|
|
assert.isString('_spender', _spender);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncodedTransactionData = self._strictEncodeArguments('approve(address,uint256)', [
|
|
_spender.toLowerCase(),
|
|
_value,
|
|
]);
|
|
return abiEncodedTransactionData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded transaction data into its input arguments
|
|
* @param callData The ABI-encoded transaction data
|
|
* @returns An array representing the input arguments in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedTransactionData(callData: string): string {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('approve(address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedCallData = abiEncoder.strictDecode<string>(callData);
|
|
return abiDecodedCallData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded return data from a transaction
|
|
* @param returnData the data returned after transaction execution
|
|
* @returns An array representing the output results in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedReturnData(returnData: string): boolean {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('approve(address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedReturnData = abiEncoder.strictDecodeReturnValue<boolean>(returnData);
|
|
return abiDecodedReturnData;
|
|
},
|
|
};
|
|
/**
|
|
* Query total supply of token
|
|
*/
|
|
public totalSupply = {
|
|
/**
|
|
* Sends a read-only call to the contract method. Returns the result that would happen if one were to send an
|
|
* Ethereum transaction to this method, given the current state of the blockchain. Calls do not cost gas
|
|
* since they don't modify state.
|
|
* @returns Total supply of token
|
|
*/
|
|
async callAsync(callData: Partial<CallData> = {}, defaultBlock?: BlockParam): Promise<BigNumber> {
|
|
assert.doesConformToSchema('callData', callData, schemas.callDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (defaultBlock !== undefined) {
|
|
assert.isBlockParam('defaultBlock', defaultBlock);
|
|
}
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('totalSupply()', []);
|
|
const callDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...callData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
callDataWithDefaults.from = callDataWithDefaults.from
|
|
? callDataWithDefaults.from.toLowerCase()
|
|
: callDataWithDefaults.from;
|
|
let rawCallResult;
|
|
try {
|
|
rawCallResult = await self._web3Wrapper.callAsync(callDataWithDefaults, defaultBlock);
|
|
} catch (err) {
|
|
BaseContract._throwIfThrownErrorIsRevertError(err);
|
|
throw err;
|
|
}
|
|
BaseContract._throwIfCallResultIsRevertError(rawCallResult);
|
|
const abiEncoder = self._lookupAbiEncoder('totalSupply()');
|
|
// tslint:disable boolean-naming
|
|
const result = abiEncoder.strictDecodeReturnValue<BigNumber>(rawCallResult);
|
|
// tslint:enable boolean-naming
|
|
return result;
|
|
},
|
|
/**
|
|
* Returns the ABI encoded transaction data needed to send an Ethereum transaction calling this method. Before
|
|
* sending the Ethereum tx, this encoded tx data can first be sent to a separate signing service or can be used
|
|
* to create a 0x transaction (see protocol spec for more details).
|
|
* @returns The ABI encoded transaction data as a string
|
|
*/
|
|
getABIEncodedTransactionData(): string {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncodedTransactionData = self._strictEncodeArguments('totalSupply()', []);
|
|
return abiEncodedTransactionData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded transaction data into its input arguments
|
|
* @param callData The ABI-encoded transaction data
|
|
* @returns An array representing the input arguments in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedTransactionData(callData: string): void {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('totalSupply()');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedCallData = abiEncoder.strictDecode<void>(callData);
|
|
return abiDecodedCallData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded return data from a transaction
|
|
* @param returnData the data returned after transaction execution
|
|
* @returns An array representing the output results in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedReturnData(returnData: string): BigNumber {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('totalSupply()');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedReturnData = abiEncoder.strictDecodeReturnValue<BigNumber>(returnData);
|
|
return abiDecodedReturnData;
|
|
},
|
|
};
|
|
/**
|
|
* send `value` token to `to` from `from` on the condition it is approved by `from`
|
|
*/
|
|
public transferFrom = {
|
|
/**
|
|
* Sends an Ethereum transaction executing this method with the supplied parameters. This is a read/write
|
|
* Ethereum operation and will cost gas.
|
|
* @param _from The address of the sender
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @param txData Additional data for transaction
|
|
* @returns The hash of the transaction
|
|
*/
|
|
async sendTransactionAsync(
|
|
_from: string,
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<string> {
|
|
assert.isString('_from', _from);
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('transferFrom(address,address,uint256)', [
|
|
_from.toLowerCase(),
|
|
_to.toLowerCase(),
|
|
_value,
|
|
]);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...txData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
if (txDataWithDefaults.from !== undefined) {
|
|
txDataWithDefaults.from = txDataWithDefaults.from.toLowerCase();
|
|
}
|
|
|
|
const txHash = await self._web3Wrapper.sendTransactionAsync(txDataWithDefaults);
|
|
return txHash;
|
|
},
|
|
/**
|
|
* Sends an Ethereum transaction and waits until the transaction has been successfully mined without reverting.
|
|
* If the transaction was mined, but reverted, an error is thrown.
|
|
* @param _from The address of the sender
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @param txData Additional data for transaction
|
|
* @param pollingIntervalMs Interval at which to poll for success
|
|
* @returns A promise that resolves when the transaction is successful
|
|
*/
|
|
awaitTransactionSuccessAsync(
|
|
_from: string,
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData>,
|
|
pollingIntervalMs?: number,
|
|
timeoutMs?: number,
|
|
): PromiseWithTransactionHash<TransactionReceiptWithDecodedLogs> {
|
|
assert.isString('_from', _from);
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const txHashPromise = self.transferFrom.sendTransactionAsync(
|
|
_from.toLowerCase(),
|
|
_to.toLowerCase(),
|
|
_value,
|
|
txData,
|
|
);
|
|
return new PromiseWithTransactionHash<TransactionReceiptWithDecodedLogs>(
|
|
txHashPromise,
|
|
(async (): Promise<TransactionReceiptWithDecodedLogs> => {
|
|
// When the transaction hash resolves, wait for it to be mined.
|
|
return self._web3Wrapper.awaitTransactionSuccessAsync(
|
|
await txHashPromise,
|
|
pollingIntervalMs,
|
|
timeoutMs,
|
|
);
|
|
})(),
|
|
);
|
|
},
|
|
/**
|
|
* Estimates the gas cost of sending an Ethereum transaction calling this method with these arguments.
|
|
* @param _from The address of the sender
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @param txData Additional data for transaction
|
|
* @returns The hash of the transaction
|
|
*/
|
|
async estimateGasAsync(
|
|
_from: string,
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<number> {
|
|
assert.isString('_from', _from);
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('transferFrom(address,address,uint256)', [
|
|
_from.toLowerCase(),
|
|
_to.toLowerCase(),
|
|
_value,
|
|
]);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...txData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
if (txDataWithDefaults.from !== undefined) {
|
|
txDataWithDefaults.from = txDataWithDefaults.from.toLowerCase();
|
|
}
|
|
|
|
const gas = await self._web3Wrapper.estimateGasAsync(txDataWithDefaults);
|
|
return gas;
|
|
},
|
|
async validateAndSendTransactionAsync(
|
|
_from: string,
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<string> {
|
|
await (this as any).transferFrom.callAsync(_from, _to, _value, txData);
|
|
const txHash = await (this as any).transferFrom.sendTransactionAsync(_from, _to, _value, txData);
|
|
return txHash;
|
|
},
|
|
/**
|
|
* Sends a read-only call to the contract method. Returns the result that would happen if one were to send an
|
|
* Ethereum transaction to this method, given the current state of the blockchain. Calls do not cost gas
|
|
* since they don't modify state.
|
|
* @param _from The address of the sender
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @returns True if transfer was successful
|
|
*/
|
|
async callAsync(
|
|
_from: string,
|
|
_to: string,
|
|
_value: BigNumber,
|
|
callData: Partial<CallData> = {},
|
|
defaultBlock?: BlockParam,
|
|
): Promise<boolean> {
|
|
assert.isString('_from', _from);
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
assert.doesConformToSchema('callData', callData, schemas.callDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (defaultBlock !== undefined) {
|
|
assert.isBlockParam('defaultBlock', defaultBlock);
|
|
}
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('transferFrom(address,address,uint256)', [
|
|
_from.toLowerCase(),
|
|
_to.toLowerCase(),
|
|
_value,
|
|
]);
|
|
const callDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...callData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
callDataWithDefaults.from = callDataWithDefaults.from
|
|
? callDataWithDefaults.from.toLowerCase()
|
|
: callDataWithDefaults.from;
|
|
let rawCallResult;
|
|
try {
|
|
rawCallResult = await self._web3Wrapper.callAsync(callDataWithDefaults, defaultBlock);
|
|
} catch (err) {
|
|
BaseContract._throwIfThrownErrorIsRevertError(err);
|
|
throw err;
|
|
}
|
|
BaseContract._throwIfCallResultIsRevertError(rawCallResult);
|
|
const abiEncoder = self._lookupAbiEncoder('transferFrom(address,address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const result = abiEncoder.strictDecodeReturnValue<boolean>(rawCallResult);
|
|
// tslint:enable boolean-naming
|
|
return result;
|
|
},
|
|
/**
|
|
* Returns the ABI encoded transaction data needed to send an Ethereum transaction calling this method. Before
|
|
* sending the Ethereum tx, this encoded tx data can first be sent to a separate signing service or can be used
|
|
* to create a 0x transaction (see protocol spec for more details).
|
|
* @param _from The address of the sender
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @returns The ABI encoded transaction data as a string
|
|
*/
|
|
getABIEncodedTransactionData(_from: string, _to: string, _value: BigNumber): string {
|
|
assert.isString('_from', _from);
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncodedTransactionData = self._strictEncodeArguments('transferFrom(address,address,uint256)', [
|
|
_from.toLowerCase(),
|
|
_to.toLowerCase(),
|
|
_value,
|
|
]);
|
|
return abiEncodedTransactionData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded transaction data into its input arguments
|
|
* @param callData The ABI-encoded transaction data
|
|
* @returns An array representing the input arguments in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedTransactionData(callData: string): string {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('transferFrom(address,address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedCallData = abiEncoder.strictDecode<string>(callData);
|
|
return abiDecodedCallData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded return data from a transaction
|
|
* @param returnData the data returned after transaction execution
|
|
* @returns An array representing the output results in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedReturnData(returnData: string): boolean {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('transferFrom(address,address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedReturnData = abiEncoder.strictDecodeReturnValue<boolean>(returnData);
|
|
return abiDecodedReturnData;
|
|
},
|
|
};
|
|
/**
|
|
* Query the balance of owner
|
|
*/
|
|
public balanceOf = {
|
|
/**
|
|
* Sends a read-only call to the contract method. Returns the result that would happen if one were to send an
|
|
* Ethereum transaction to this method, given the current state of the blockchain. Calls do not cost gas
|
|
* since they don't modify state.
|
|
* @param _owner The address from which the balance will be retrieved
|
|
* @returns Balance of owner
|
|
*/
|
|
async callAsync(
|
|
_owner: string,
|
|
callData: Partial<CallData> = {},
|
|
defaultBlock?: BlockParam,
|
|
): Promise<BigNumber> {
|
|
assert.isString('_owner', _owner);
|
|
assert.doesConformToSchema('callData', callData, schemas.callDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (defaultBlock !== undefined) {
|
|
assert.isBlockParam('defaultBlock', defaultBlock);
|
|
}
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('balanceOf(address)', [_owner.toLowerCase()]);
|
|
const callDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...callData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
callDataWithDefaults.from = callDataWithDefaults.from
|
|
? callDataWithDefaults.from.toLowerCase()
|
|
: callDataWithDefaults.from;
|
|
let rawCallResult;
|
|
try {
|
|
rawCallResult = await self._web3Wrapper.callAsync(callDataWithDefaults, defaultBlock);
|
|
} catch (err) {
|
|
BaseContract._throwIfThrownErrorIsRevertError(err);
|
|
throw err;
|
|
}
|
|
BaseContract._throwIfCallResultIsRevertError(rawCallResult);
|
|
const abiEncoder = self._lookupAbiEncoder('balanceOf(address)');
|
|
// tslint:disable boolean-naming
|
|
const result = abiEncoder.strictDecodeReturnValue<BigNumber>(rawCallResult);
|
|
// tslint:enable boolean-naming
|
|
return result;
|
|
},
|
|
/**
|
|
* Returns the ABI encoded transaction data needed to send an Ethereum transaction calling this method. Before
|
|
* sending the Ethereum tx, this encoded tx data can first be sent to a separate signing service or can be used
|
|
* to create a 0x transaction (see protocol spec for more details).
|
|
* @param _owner The address from which the balance will be retrieved
|
|
* @returns The ABI encoded transaction data as a string
|
|
*/
|
|
getABIEncodedTransactionData(_owner: string): string {
|
|
assert.isString('_owner', _owner);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncodedTransactionData = self._strictEncodeArguments('balanceOf(address)', [_owner.toLowerCase()]);
|
|
return abiEncodedTransactionData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded transaction data into its input arguments
|
|
* @param callData The ABI-encoded transaction data
|
|
* @returns An array representing the input arguments in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedTransactionData(callData: string): string {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('balanceOf(address)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedCallData = abiEncoder.strictDecode<string>(callData);
|
|
return abiDecodedCallData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded return data from a transaction
|
|
* @param returnData the data returned after transaction execution
|
|
* @returns An array representing the output results in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedReturnData(returnData: string): BigNumber {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('balanceOf(address)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedReturnData = abiEncoder.strictDecodeReturnValue<BigNumber>(returnData);
|
|
return abiDecodedReturnData;
|
|
},
|
|
};
|
|
/**
|
|
* send `value` token to `to` from `msg.sender`
|
|
*/
|
|
public transfer = {
|
|
/**
|
|
* Sends an Ethereum transaction executing this method with the supplied parameters. This is a read/write
|
|
* Ethereum operation and will cost gas.
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @param txData Additional data for transaction
|
|
* @returns The hash of the transaction
|
|
*/
|
|
async sendTransactionAsync(
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<string> {
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('transfer(address,uint256)', [_to.toLowerCase(), _value]);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...txData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
if (txDataWithDefaults.from !== undefined) {
|
|
txDataWithDefaults.from = txDataWithDefaults.from.toLowerCase();
|
|
}
|
|
|
|
const txHash = await self._web3Wrapper.sendTransactionAsync(txDataWithDefaults);
|
|
return txHash;
|
|
},
|
|
/**
|
|
* Sends an Ethereum transaction and waits until the transaction has been successfully mined without reverting.
|
|
* If the transaction was mined, but reverted, an error is thrown.
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @param txData Additional data for transaction
|
|
* @param pollingIntervalMs Interval at which to poll for success
|
|
* @returns A promise that resolves when the transaction is successful
|
|
*/
|
|
awaitTransactionSuccessAsync(
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData>,
|
|
pollingIntervalMs?: number,
|
|
timeoutMs?: number,
|
|
): PromiseWithTransactionHash<TransactionReceiptWithDecodedLogs> {
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const txHashPromise = self.transfer.sendTransactionAsync(_to.toLowerCase(), _value, txData);
|
|
return new PromiseWithTransactionHash<TransactionReceiptWithDecodedLogs>(
|
|
txHashPromise,
|
|
(async (): Promise<TransactionReceiptWithDecodedLogs> => {
|
|
// When the transaction hash resolves, wait for it to be mined.
|
|
return self._web3Wrapper.awaitTransactionSuccessAsync(
|
|
await txHashPromise,
|
|
pollingIntervalMs,
|
|
timeoutMs,
|
|
);
|
|
})(),
|
|
);
|
|
},
|
|
/**
|
|
* Estimates the gas cost of sending an Ethereum transaction calling this method with these arguments.
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @param txData Additional data for transaction
|
|
* @returns The hash of the transaction
|
|
*/
|
|
async estimateGasAsync(_to: string, _value: BigNumber, txData?: Partial<TxData> | undefined): Promise<number> {
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('transfer(address,uint256)', [_to.toLowerCase(), _value]);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...txData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
if (txDataWithDefaults.from !== undefined) {
|
|
txDataWithDefaults.from = txDataWithDefaults.from.toLowerCase();
|
|
}
|
|
|
|
const gas = await self._web3Wrapper.estimateGasAsync(txDataWithDefaults);
|
|
return gas;
|
|
},
|
|
async validateAndSendTransactionAsync(
|
|
_to: string,
|
|
_value: BigNumber,
|
|
txData?: Partial<TxData> | undefined,
|
|
): Promise<string> {
|
|
await (this as any).transfer.callAsync(_to, _value, txData);
|
|
const txHash = await (this as any).transfer.sendTransactionAsync(_to, _value, txData);
|
|
return txHash;
|
|
},
|
|
/**
|
|
* Sends a read-only call to the contract method. Returns the result that would happen if one were to send an
|
|
* Ethereum transaction to this method, given the current state of the blockchain. Calls do not cost gas
|
|
* since they don't modify state.
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @returns True if transfer was successful
|
|
*/
|
|
async callAsync(
|
|
_to: string,
|
|
_value: BigNumber,
|
|
callData: Partial<CallData> = {},
|
|
defaultBlock?: BlockParam,
|
|
): Promise<boolean> {
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
assert.doesConformToSchema('callData', callData, schemas.callDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (defaultBlock !== undefined) {
|
|
assert.isBlockParam('defaultBlock', defaultBlock);
|
|
}
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('transfer(address,uint256)', [_to.toLowerCase(), _value]);
|
|
const callDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...callData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
callDataWithDefaults.from = callDataWithDefaults.from
|
|
? callDataWithDefaults.from.toLowerCase()
|
|
: callDataWithDefaults.from;
|
|
let rawCallResult;
|
|
try {
|
|
rawCallResult = await self._web3Wrapper.callAsync(callDataWithDefaults, defaultBlock);
|
|
} catch (err) {
|
|
BaseContract._throwIfThrownErrorIsRevertError(err);
|
|
throw err;
|
|
}
|
|
BaseContract._throwIfCallResultIsRevertError(rawCallResult);
|
|
const abiEncoder = self._lookupAbiEncoder('transfer(address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const result = abiEncoder.strictDecodeReturnValue<boolean>(rawCallResult);
|
|
// tslint:enable boolean-naming
|
|
return result;
|
|
},
|
|
/**
|
|
* Returns the ABI encoded transaction data needed to send an Ethereum transaction calling this method. Before
|
|
* sending the Ethereum tx, this encoded tx data can first be sent to a separate signing service or can be used
|
|
* to create a 0x transaction (see protocol spec for more details).
|
|
* @param _to The address of the recipient
|
|
* @param _value The amount of token to be transferred
|
|
* @returns The ABI encoded transaction data as a string
|
|
*/
|
|
getABIEncodedTransactionData(_to: string, _value: BigNumber): string {
|
|
assert.isString('_to', _to);
|
|
assert.isBigNumber('_value', _value);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncodedTransactionData = self._strictEncodeArguments('transfer(address,uint256)', [
|
|
_to.toLowerCase(),
|
|
_value,
|
|
]);
|
|
return abiEncodedTransactionData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded transaction data into its input arguments
|
|
* @param callData The ABI-encoded transaction data
|
|
* @returns An array representing the input arguments in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedTransactionData(callData: string): string {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('transfer(address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedCallData = abiEncoder.strictDecode<string>(callData);
|
|
return abiDecodedCallData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded return data from a transaction
|
|
* @param returnData the data returned after transaction execution
|
|
* @returns An array representing the output results in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedReturnData(returnData: string): boolean {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('transfer(address,uint256)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedReturnData = abiEncoder.strictDecodeReturnValue<boolean>(returnData);
|
|
return abiDecodedReturnData;
|
|
},
|
|
};
|
|
public allowance = {
|
|
/**
|
|
* Sends a read-only call to the contract method. Returns the result that would happen if one were to send an
|
|
* Ethereum transaction to this method, given the current state of the blockchain. Calls do not cost gas
|
|
* since they don't modify state.
|
|
* @param _owner The address of the account owning tokens
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @returns Amount of remaining tokens allowed to spent
|
|
*/
|
|
async callAsync(
|
|
_owner: string,
|
|
_spender: string,
|
|
callData: Partial<CallData> = {},
|
|
defaultBlock?: BlockParam,
|
|
): Promise<BigNumber> {
|
|
assert.isString('_owner', _owner);
|
|
assert.isString('_spender', _spender);
|
|
assert.doesConformToSchema('callData', callData, schemas.callDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (defaultBlock !== undefined) {
|
|
assert.isBlockParam('defaultBlock', defaultBlock);
|
|
}
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const encodedData = self._strictEncodeArguments('allowance(address,address)', [
|
|
_owner.toLowerCase(),
|
|
_spender.toLowerCase(),
|
|
]);
|
|
const callDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{
|
|
to: self.address,
|
|
...callData,
|
|
data: encodedData,
|
|
},
|
|
self._web3Wrapper.getContractDefaults(),
|
|
);
|
|
callDataWithDefaults.from = callDataWithDefaults.from
|
|
? callDataWithDefaults.from.toLowerCase()
|
|
: callDataWithDefaults.from;
|
|
let rawCallResult;
|
|
try {
|
|
rawCallResult = await self._web3Wrapper.callAsync(callDataWithDefaults, defaultBlock);
|
|
} catch (err) {
|
|
BaseContract._throwIfThrownErrorIsRevertError(err);
|
|
throw err;
|
|
}
|
|
BaseContract._throwIfCallResultIsRevertError(rawCallResult);
|
|
const abiEncoder = self._lookupAbiEncoder('allowance(address,address)');
|
|
// tslint:disable boolean-naming
|
|
const result = abiEncoder.strictDecodeReturnValue<BigNumber>(rawCallResult);
|
|
// tslint:enable boolean-naming
|
|
return result;
|
|
},
|
|
/**
|
|
* Returns the ABI encoded transaction data needed to send an Ethereum transaction calling this method. Before
|
|
* sending the Ethereum tx, this encoded tx data can first be sent to a separate signing service or can be used
|
|
* to create a 0x transaction (see protocol spec for more details).
|
|
* @param _owner The address of the account owning tokens
|
|
* @param _spender The address of the account able to transfer the tokens
|
|
* @returns The ABI encoded transaction data as a string
|
|
*/
|
|
getABIEncodedTransactionData(_owner: string, _spender: string): string {
|
|
assert.isString('_owner', _owner);
|
|
assert.isString('_spender', _spender);
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncodedTransactionData = self._strictEncodeArguments('allowance(address,address)', [
|
|
_owner.toLowerCase(),
|
|
_spender.toLowerCase(),
|
|
]);
|
|
return abiEncodedTransactionData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded transaction data into its input arguments
|
|
* @param callData The ABI-encoded transaction data
|
|
* @returns An array representing the input arguments in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedTransactionData(callData: string): string {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('allowance(address,address)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedCallData = abiEncoder.strictDecode<string>(callData);
|
|
return abiDecodedCallData;
|
|
},
|
|
/**
|
|
* Decode the ABI-encoded return data from a transaction
|
|
* @param returnData the data returned after transaction execution
|
|
* @returns An array representing the output results in order. Keynames of nested structs are preserved.
|
|
*/
|
|
getABIDecodedReturnData(returnData: string): BigNumber {
|
|
const self = (this as any) as ERC20TokenContract;
|
|
const abiEncoder = self._lookupAbiEncoder('allowance(address,address)');
|
|
// tslint:disable boolean-naming
|
|
const abiDecodedReturnData = abiEncoder.strictDecodeReturnValue<BigNumber>(returnData);
|
|
return abiDecodedReturnData;
|
|
},
|
|
};
|
|
private readonly _subscriptionManager: SubscriptionManager<ERC20TokenEventArgs, ERC20TokenEvents>;
|
|
public static async deployFrom0xArtifactAsync(
|
|
artifact: ContractArtifact | SimpleContractArtifact,
|
|
supportedProvider: SupportedProvider,
|
|
txDefaults: Partial<TxData>,
|
|
logDecodeDependencies: { [contractName: string]: ContractArtifact | SimpleContractArtifact },
|
|
): Promise<ERC20TokenContract> {
|
|
assert.doesConformToSchema('txDefaults', txDefaults, schemas.txDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
if (artifact.compilerOutput === undefined) {
|
|
throw new Error('Compiler output not found in the artifact file');
|
|
}
|
|
const provider = providerUtils.standardizeOrThrow(supportedProvider);
|
|
const bytecode = artifact.compilerOutput.evm.bytecode.object;
|
|
const abi = artifact.compilerOutput.abi;
|
|
const logDecodeDependenciesAbiOnly: { [contractName: string]: ContractAbi } = {};
|
|
if (Object.keys(logDecodeDependencies) !== undefined) {
|
|
for (const key of Object.keys(logDecodeDependencies)) {
|
|
logDecodeDependenciesAbiOnly[key] = logDecodeDependencies[key].compilerOutput.abi;
|
|
}
|
|
}
|
|
return ERC20TokenContract.deployAsync(bytecode, abi, provider, txDefaults, logDecodeDependenciesAbiOnly);
|
|
}
|
|
public static async deployAsync(
|
|
bytecode: string,
|
|
abi: ContractAbi,
|
|
supportedProvider: SupportedProvider,
|
|
txDefaults: Partial<TxData>,
|
|
logDecodeDependencies: { [contractName: string]: ContractAbi },
|
|
): Promise<ERC20TokenContract> {
|
|
assert.isHexString('bytecode', bytecode);
|
|
assert.doesConformToSchema('txDefaults', txDefaults, schemas.txDataSchema, [
|
|
schemas.addressSchema,
|
|
schemas.numberSchema,
|
|
schemas.jsNumber,
|
|
]);
|
|
const provider = providerUtils.standardizeOrThrow(supportedProvider);
|
|
const constructorAbi = BaseContract._lookupConstructorAbi(abi);
|
|
[] = BaseContract._formatABIDataItemList(constructorAbi.inputs, [], BaseContract._bigNumberToString);
|
|
const iface = new ethers.utils.Interface(abi);
|
|
const deployInfo = iface.deployFunction;
|
|
const txData = deployInfo.encode(bytecode, []);
|
|
const web3Wrapper = new Web3Wrapper(provider);
|
|
const txDataWithDefaults = await BaseContract._applyDefaultsToTxDataAsync(
|
|
{ data: txData },
|
|
txDefaults,
|
|
web3Wrapper.estimateGasAsync.bind(web3Wrapper),
|
|
);
|
|
const txHash = await web3Wrapper.sendTransactionAsync(txDataWithDefaults);
|
|
logUtils.log(`transactionHash: ${txHash}`);
|
|
const txReceipt = await web3Wrapper.awaitTransactionSuccessAsync(txHash);
|
|
logUtils.log(`ERC20Token successfully deployed at ${txReceipt.contractAddress}`);
|
|
const contractInstance = new ERC20TokenContract(
|
|
txReceipt.contractAddress as string,
|
|
provider,
|
|
txDefaults,
|
|
logDecodeDependencies,
|
|
);
|
|
contractInstance.constructorArgs = [];
|
|
return contractInstance;
|
|
}
|
|
|
|
/**
|
|
* @returns The contract ABI
|
|
*/
|
|
public static ABI(): ContractAbi {
|
|
const abi = [
|
|
{
|
|
constant: false,
|
|
inputs: [
|
|
{
|
|
name: '_spender',
|
|
type: 'address',
|
|
},
|
|
{
|
|
name: '_value',
|
|
type: 'uint256',
|
|
},
|
|
],
|
|
name: 'approve',
|
|
outputs: [
|
|
{
|
|
name: '',
|
|
type: 'bool',
|
|
},
|
|
],
|
|
payable: false,
|
|
stateMutability: 'nonpayable',
|
|
type: 'function',
|
|
},
|
|
{
|
|
constant: true,
|
|
inputs: [],
|
|
name: 'totalSupply',
|
|
outputs: [
|
|
{
|
|
name: '',
|
|
type: 'uint256',
|
|
},
|
|
],
|
|
payable: false,
|
|
stateMutability: 'view',
|
|
type: 'function',
|
|
},
|
|
{
|
|
constant: false,
|
|
inputs: [
|
|
{
|
|
name: '_from',
|
|
type: 'address',
|
|
},
|
|
{
|
|
name: '_to',
|
|
type: 'address',
|
|
},
|
|
{
|
|
name: '_value',
|
|
type: 'uint256',
|
|
},
|
|
],
|
|
name: 'transferFrom',
|
|
outputs: [
|
|
{
|
|
name: '',
|
|
type: 'bool',
|
|
},
|
|
],
|
|
payable: false,
|
|
stateMutability: 'nonpayable',
|
|
type: 'function',
|
|
},
|
|
{
|
|
constant: true,
|
|
inputs: [
|
|
{
|
|
name: '_owner',
|
|
type: 'address',
|
|
},
|
|
],
|
|
name: 'balanceOf',
|
|
outputs: [
|
|
{
|
|
name: '',
|
|
type: 'uint256',
|
|
},
|
|
],
|
|
payable: false,
|
|
stateMutability: 'view',
|
|
type: 'function',
|
|
},
|
|
{
|
|
constant: false,
|
|
inputs: [
|
|
{
|
|
name: '_to',
|
|
type: 'address',
|
|
},
|
|
{
|
|
name: '_value',
|
|
type: 'uint256',
|
|
},
|
|
],
|
|
name: 'transfer',
|
|
outputs: [
|
|
{
|
|
name: '',
|
|
type: 'bool',
|
|
},
|
|
],
|
|
payable: false,
|
|
stateMutability: 'nonpayable',
|
|
type: 'function',
|
|
},
|
|
{
|
|
constant: true,
|
|
inputs: [
|
|
{
|
|
name: '_owner',
|
|
type: 'address',
|
|
},
|
|
{
|
|
name: '_spender',
|
|
type: 'address',
|
|
},
|
|
],
|
|
name: 'allowance',
|
|
outputs: [
|
|
{
|
|
name: '',
|
|
type: 'uint256',
|
|
},
|
|
],
|
|
payable: false,
|
|
stateMutability: 'view',
|
|
type: 'function',
|
|
},
|
|
{
|
|
anonymous: false,
|
|
inputs: [
|
|
{
|
|
name: '_from',
|
|
type: 'address',
|
|
indexed: true,
|
|
},
|
|
{
|
|
name: '_to',
|
|
type: 'address',
|
|
indexed: true,
|
|
},
|
|
{
|
|
name: '_value',
|
|
type: 'uint256',
|
|
indexed: false,
|
|
},
|
|
],
|
|
name: 'Transfer',
|
|
outputs: [],
|
|
type: 'event',
|
|
},
|
|
{
|
|
anonymous: false,
|
|
inputs: [
|
|
{
|
|
name: '_owner',
|
|
type: 'address',
|
|
indexed: true,
|
|
},
|
|
{
|
|
name: '_spender',
|
|
type: 'address',
|
|
indexed: true,
|
|
},
|
|
{
|
|
name: '_value',
|
|
type: 'uint256',
|
|
indexed: false,
|
|
},
|
|
],
|
|
name: 'Approval',
|
|
outputs: [],
|
|
type: 'event',
|
|
},
|
|
] as ContractAbi;
|
|
return abi;
|
|
}
|
|
/**
|
|
* Subscribe to an event type emitted by the ERC20Token contract.
|
|
* @param eventName The ERC20Token contract event you would like to subscribe to.
|
|
* @param indexFilterValues An object where the keys are indexed args returned by the event and
|
|
* the value is the value you are interested in. E.g `{maker: aUserAddressHex}`
|
|
* @param callback Callback that gets called when a log is added/removed
|
|
* @param isVerbose Enable verbose subscription warnings (e.g recoverable network issues encountered)
|
|
* @return Subscription token used later to unsubscribe
|
|
*/
|
|
public subscribe<ArgsType extends ERC20TokenEventArgs>(
|
|
eventName: ERC20TokenEvents,
|
|
indexFilterValues: IndexedFilterValues,
|
|
callback: EventCallback<ArgsType>,
|
|
isVerbose: boolean = false,
|
|
blockPollingIntervalMs?: number,
|
|
): string {
|
|
assert.doesBelongToStringEnum('eventName', eventName, ERC20TokenEvents);
|
|
assert.doesConformToSchema('indexFilterValues', indexFilterValues, schemas.indexFilterValuesSchema);
|
|
assert.isFunction('callback', callback);
|
|
const subscriptionToken = this._subscriptionManager.subscribe<ArgsType>(
|
|
this.address,
|
|
eventName,
|
|
indexFilterValues,
|
|
ERC20TokenContract.ABI(),
|
|
callback,
|
|
isVerbose,
|
|
blockPollingIntervalMs,
|
|
);
|
|
return subscriptionToken;
|
|
}
|
|
/**
|
|
* Cancel a subscription
|
|
* @param subscriptionToken Subscription token returned by `subscribe()`
|
|
*/
|
|
public unsubscribe(subscriptionToken: string): void {
|
|
this._subscriptionManager.unsubscribe(subscriptionToken);
|
|
}
|
|
/**
|
|
* Cancels all existing subscriptions
|
|
*/
|
|
public unsubscribeAll(): void {
|
|
this._subscriptionManager.unsubscribeAll();
|
|
}
|
|
/**
|
|
* Gets historical logs without creating a subscription
|
|
* @param eventName The ERC20Token contract event you would like to subscribe to.
|
|
* @param blockRange Block range to get logs from.
|
|
* @param indexFilterValues An object where the keys are indexed args returned by the event and
|
|
* the value is the value you are interested in. E.g `{_from: aUserAddressHex}`
|
|
* @return Array of logs that match the parameters
|
|
*/
|
|
public async getLogsAsync<ArgsType extends ERC20TokenEventArgs>(
|
|
eventName: ERC20TokenEvents,
|
|
blockRange: BlockRange,
|
|
indexFilterValues: IndexedFilterValues,
|
|
): Promise<Array<LogWithDecodedArgs<ArgsType>>> {
|
|
assert.doesBelongToStringEnum('eventName', eventName, ERC20TokenEvents);
|
|
assert.doesConformToSchema('blockRange', blockRange, schemas.blockRangeSchema);
|
|
assert.doesConformToSchema('indexFilterValues', indexFilterValues, schemas.indexFilterValuesSchema);
|
|
const logs = await this._subscriptionManager.getLogsAsync<ArgsType>(
|
|
this.address,
|
|
eventName,
|
|
blockRange,
|
|
indexFilterValues,
|
|
ERC20TokenContract.ABI(),
|
|
);
|
|
return logs;
|
|
}
|
|
constructor(
|
|
address: string,
|
|
supportedProvider: SupportedProvider,
|
|
txDefaults?: Partial<TxData>,
|
|
logDecodeDependencies?: { [contractName: string]: ContractAbi },
|
|
deployedBytecode: string | undefined = ERC20TokenContract.deployedBytecode,
|
|
) {
|
|
super(
|
|
'ERC20Token',
|
|
ERC20TokenContract.ABI(),
|
|
address,
|
|
supportedProvider,
|
|
txDefaults,
|
|
logDecodeDependencies,
|
|
deployedBytecode,
|
|
);
|
|
classUtils.bindAll(this, ['_abiEncoderByFunctionSignature', 'address', '_web3Wrapper']);
|
|
this._subscriptionManager = new SubscriptionManager<ERC20TokenEventArgs, ERC20TokenEvents>(
|
|
ERC20TokenContract.ABI(),
|
|
this._web3Wrapper,
|
|
);
|
|
}
|
|
}
|
|
|
|
// tslint:disable:max-file-line-count
|
|
// tslint:enable:no-unbound-method no-parameter-reassignment no-consecutive-blank-lines ordered-imports align
|
|
// tslint:enable:trailing-comma whitespace no-trailing-whitespace
|