def make_force_payment_to_provider(
requestor_eth_address: str,
provider_eth_address: str,
value: int,
payment_ts: int,
) -> str:
"""
Concent makes transaction from requestor's deposit to provider's account on amount 'value'.
If there is less then 'value' on requestor's deposit, Concent transfers as much as possible.
"""
assert isinstance(
requestor_eth_address,
str) and len(requestor_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(
provider_eth_address,
str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(payment_ts, int) and payment_ts >= 0
assert isinstance(value, int) and value >= 0
requestor_account_balance = PaymentInterface().get_deposit_value(
Web3.toChecksumAddress(requestor_eth_address)) # type: ignore # pylint: disable=no-member
if requestor_account_balance < value:
value = requestor_account_balance
return PaymentInterface().force_payment( # type: ignore # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
value=value,
closure_time=payment_ts,
)
def get_deposit_value(client_eth_address: str) -> int:
assert isinstance(
client_eth_address,
str) and len(client_eth_address) == ETHEREUM_ADDRESS_LENGTH
return PaymentInterface().get_deposit_value(
Web3.toChecksumAddress(client_eth_address)) # type: ignore # pylint: disable=no-member
def force_subtask_payment(
requestor_eth_address: str,
provider_eth_address: str,
value: int,
subtask_id: str,
v: int,
r: bytes,
s: bytes,
reimburse_amount: int,
) -> str:
assert isinstance(requestor_eth_address, str) and len(requestor_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(provider_eth_address, str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(subtask_id, str)
validate_value_is_int_convertible_and_non_negative(value)
return PaymentInterface().force_subtask_payment( # type: ignore # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
value=int(value),
subtask_id=_hexencode_uuid(subtask_id),
v=v,
r=r,
s=s,
reimburse_amount=reimburse_amount,
)
def register_confirmed_transaction_handler(
tx_hash: str,
callback: Callable
) -> None:
PaymentInterface().on_transaction_confirmed( # type: ignore # pylint: disable=no-member
tx_hash=tx_hash,
cb=callback,
)
def wrapper(*args: Any, **kwargs: Any) -> None:
if PaymentInterface().is_synchronized(): # type: ignore # pylint: disable=no-member
try:
return sci_function(*args, **kwargs)
except ValueError as exception:
if "There are currently no blocks after" in str(exception):
return [] # type: ignore
else:
raise
else:
raise SCINotSynchronized(
'SCI is currently not synchronized',
ErrorCode.SCI_NOT_SYNCHRONIZED,
)
def get_covered_additional_verification_costs(client_eth_address: str, payment_ts: int) -> list:
assert isinstance(client_eth_address, str) and len(client_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(payment_ts, int) and payment_ts >= 0
payment_interface: SCIImplementation = PaymentInterface()
first_block_after_payment_number = BlocksHelper(payment_interface).get_latest_existing_block_at(payment_ts).number
return payment_interface.get_covered_additional_verification_costs( # pylint: disable=no-member
address=Web3.toChecksumAddress(client_eth_address),
# We start few blocks before first matching block because additional verification payments
# do not have closure_time so we are relying on blockchain timestamps
from_block=first_block_after_payment_number - PAYMENTS_FROM_BLOCK_SAFETY_MARGIN,
to_block=payment_interface.get_latest_confirmed_block_number() - payment_interface.REQUIRED_CONFS, # pylint: disable=no-member
)
def make_settlement_payment(
requestor_eth_address: str,
provider_eth_address: str,
value: List[int],
subtask_ids: List[str],
closure_time: int,
v: List[int],
r: List[bytes],
s: List[bytes],
reimburse_amount: int,
) -> str:
"""
Makes forced transaction from requestor's deposit to provider's account on amount 'reimburse_amount'.
If there is less then 'reimburse_amount' on requestor's deposit, Concent transfers as much as possible.
"""
assert isinstance(requestor_eth_address, str) and len(requestor_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(provider_eth_address, str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(closure_time, int) and closure_time >= 0
validate_value_is_int_convertible_and_positive(reimburse_amount)
requestor_account_balance = PaymentInterface().get_deposit_value(Web3.toChecksumAddress(requestor_eth_address)) # type: ignore # pylint: disable=no-member
if requestor_account_balance < reimburse_amount:
reimburse_amount = requestor_account_balance
return PaymentInterface().force_payment( # type: ignore # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
value=value,
subtask_id=[_hexencode_uuid(subtask_id) for subtask_id in subtask_ids],
v=v,
r=r,
s=s,
reimburse_amount=reimburse_amount,
closure_time=closure_time,
)
def get_list_of_payments(
requestor_eth_address: str,
provider_eth_address: str,
min_block_timestamp: int,
transaction_type: TransactionType,
) -> list:
"""
Function which return list of transactions from payment API
where timestamp >= T0
"""
assert isinstance(requestor_eth_address, str) and len(requestor_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(provider_eth_address, str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(min_block_timestamp, int) and min_block_timestamp >= 0
assert isinstance(transaction_type, Enum) and transaction_type in TransactionType
payment_interface: SCIImplementation = PaymentInterface()
payments: list = []
first_block_after_payment_number = BlocksHelper(payment_interface).get_latest_existing_block_at(min_block_timestamp).number
latest_block_number = payment_interface.get_latest_confirmed_block_number() # pylint: disable=no-member
if latest_block_number - first_block_after_payment_number < payment_interface.REQUIRED_CONFS: # pylint: disable=no-member
return payments
if transaction_type == TransactionType.SETTLEMENT:
payments = payment_interface.get_forced_payments( # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
from_block=first_block_after_payment_number,
to_block=latest_block_number - payment_interface.REQUIRED_CONFS, # pylint: disable=no-member
)
elif transaction_type == TransactionType.BATCH:
payments = payment_interface.get_batch_transfers( # pylint: disable=no-member
payer_address=Web3.toChecksumAddress(requestor_eth_address),
payee_address=Web3.toChecksumAddress(provider_eth_address),
from_block=first_block_after_payment_number,
to_block=latest_block_number - payment_interface.REQUIRED_CONFS, # pylint: disable=no-member
)
elif transaction_type == TransactionType.FORCED_SUBTASK_PAYMENT:
payments = payment_interface.get_forced_subtask_payments( # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
# We start few blocks before first matching block because forced subtask payments
# do not have closure_time so we are relying on blockchain timestamps
from_block=first_block_after_payment_number - PAYMENTS_FROM_BLOCK_SAFETY_MARGIN,
to_block=latest_block_number - payment_interface.REQUIRED_CONFS, # pylint: disable=no-member
)
return payments
def cover_additional_verification_cost(
provider_eth_address: str,
value: int,
subtask_id: str,
) -> str:
assert isinstance(
provider_eth_address,
str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(value, int) and value > 0
assert isinstance(subtask_id, str)
return PaymentInterface().cover_additional_verification_cost( # type: ignore # pylint: disable=no-member
address=Web3.toChecksumAddress(provider_eth_address),
value=value,
subtask_id=_hexencode_uuid(subtask_id),
)
def get_list_of_payments(
requestor_eth_address: str,
provider_eth_address: str,
payment_ts: int,
transaction_type: TransactionType,
) -> list:
"""
Function which return list of transactions from payment API
where timestamp >= T0
"""
assert isinstance(
requestor_eth_address,
str) and len(requestor_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(
provider_eth_address,
str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(payment_ts, int) and payment_ts >= 0
assert isinstance(transaction_type,
Enum) and transaction_type in TransactionType
payment_interface: SmartContractsInterface = PaymentInterface()
last_block_before_payment = BlocksHelper(
payment_interface).get_first_block_after(payment_ts).number
if transaction_type == TransactionType.FORCE:
payments_list = payment_interface.get_forced_payments( # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
from_block=last_block_before_payment,
to_block=payment_interface.get_block_number(), # pylint: disable=no-member
)
elif transaction_type == TransactionType.BATCH:
payments_list = payment_interface.get_batch_transfers( # pylint: disable=no-member
payer_address=Web3.toChecksumAddress(requestor_eth_address),
payee_address=Web3.toChecksumAddress(provider_eth_address),
from_block=last_block_before_payment,
to_block=payment_interface.get_block_number(), # pylint: disable=no-member
)
return payments_list
def force_subtask_payment(
requestor_eth_address: str,
provider_eth_address: str,
value: int,
subtask_id: str,
) -> str:
assert isinstance(
requestor_eth_address,
str) and len(requestor_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(
provider_eth_address,
str) and len(provider_eth_address) == ETHEREUM_ADDRESS_LENGTH
assert isinstance(value, int) and value > 0
assert isinstance(subtask_id, str)
return PaymentInterface().force_subtask_payment( # type: ignore # pylint: disable=no-member
requestor_address=Web3.toChecksumAddress(requestor_eth_address),
provider_address=Web3.toChecksumAddress(provider_eth_address),
value=value,
subtask_id=_hexencode_uuid(subtask_id),
)
def get_transaction_count() -> int:
return PaymentInterface().get_transaction_count() # type: ignore # pylint: disable=no-member