checks.js 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120
  1. "use strict";
  2. Object.defineProperty(exports, "__esModule", { value: true });
  3. exports.resolveAddress = exports.isAddress = exports.isAddressable = void 0;
  4. const index_js_1 = require("../utils/index.js");
  5. const address_js_1 = require("./address.js");
  6. /**
  7. * Returns true if %%value%% is an object which implements the
  8. * [[Addressable]] interface.
  9. *
  10. * @example:
  11. * // Wallets and AbstractSigner sub-classes
  12. * isAddressable(Wallet.createRandom())
  13. * //_result:
  14. *
  15. * // Contracts
  16. * contract = new Contract("dai.tokens.ethers.eth", [ ], provider)
  17. * isAddressable(contract)
  18. * //_result:
  19. */
  20. function isAddressable(value) {
  21. return (value && typeof (value.getAddress) === "function");
  22. }
  23. exports.isAddressable = isAddressable;
  24. /**
  25. * Returns true if %%value%% is a valid address.
  26. *
  27. * @example:
  28. * // Valid address
  29. * isAddress("0x8ba1f109551bD432803012645Ac136ddd64DBA72")
  30. * //_result:
  31. *
  32. * // Valid ICAP address
  33. * isAddress("XE65GB6LDNXYOFTX0NSV3FUWKOWIXAMJK36")
  34. * //_result:
  35. *
  36. * // Invalid checksum
  37. * isAddress("0x8Ba1f109551bD432803012645Ac136ddd64DBa72")
  38. * //_result:
  39. *
  40. * // Invalid ICAP checksum
  41. * isAddress("0x8Ba1f109551bD432803012645Ac136ddd64DBA72")
  42. * //_result:
  43. *
  44. * // Not an address (an ENS name requires a provided and an
  45. * // asynchronous API to access)
  46. * isAddress("ricmoo.eth")
  47. * //_result:
  48. */
  49. function isAddress(value) {
  50. try {
  51. (0, address_js_1.getAddress)(value);
  52. return true;
  53. }
  54. catch (error) { }
  55. return false;
  56. }
  57. exports.isAddress = isAddress;
  58. async function checkAddress(target, promise) {
  59. const result = await promise;
  60. if (result == null || result === "0x0000000000000000000000000000000000000000") {
  61. (0, index_js_1.assert)(typeof (target) !== "string", "unconfigured name", "UNCONFIGURED_NAME", { value: target });
  62. (0, index_js_1.assertArgument)(false, "invalid AddressLike value; did not resolve to a value address", "target", target);
  63. }
  64. return (0, address_js_1.getAddress)(result);
  65. }
  66. /**
  67. * Resolves to an address for the %%target%%, which may be any
  68. * supported address type, an [[Addressable]] or a Promise which
  69. * resolves to an address.
  70. *
  71. * If an ENS name is provided, but that name has not been correctly
  72. * configured a [[UnconfiguredNameError]] is thrown.
  73. *
  74. * @example:
  75. * addr = "0x6B175474E89094C44Da98b954EedeAC495271d0F"
  76. *
  77. * // Addresses are return synchronously
  78. * resolveAddress(addr, provider)
  79. * //_result:
  80. *
  81. * // Address promises are resolved asynchronously
  82. * resolveAddress(Promise.resolve(addr))
  83. * //_result:
  84. *
  85. * // ENS names are resolved asynchronously
  86. * resolveAddress("dai.tokens.ethers.eth", provider)
  87. * //_result:
  88. *
  89. * // Addressable objects are resolved asynchronously
  90. * contract = new Contract(addr, [ ])
  91. * resolveAddress(contract, provider)
  92. * //_result:
  93. *
  94. * // Unconfigured ENS names reject
  95. * resolveAddress("nothing-here.ricmoo.eth", provider)
  96. * //_error:
  97. *
  98. * // ENS names require a NameResolver object passed in
  99. * // (notice the provider was omitted)
  100. * resolveAddress("nothing-here.ricmoo.eth")
  101. * //_error:
  102. */
  103. function resolveAddress(target, resolver) {
  104. if (typeof (target) === "string") {
  105. if (target.match(/^0x[0-9a-f]{40}$/i)) {
  106. return (0, address_js_1.getAddress)(target);
  107. }
  108. (0, index_js_1.assert)(resolver != null, "ENS resolution requires a provider", "UNSUPPORTED_OPERATION", { operation: "resolveName" });
  109. return checkAddress(target, resolver.resolveName(target));
  110. }
  111. else if (isAddressable(target)) {
  112. return checkAddress(target, target.getAddress());
  113. }
  114. else if (target && typeof (target.then) === "function") {
  115. return checkAddress(target, target);
  116. }
  117. (0, index_js_1.assertArgument)(false, "unsupported addressable value", "target", target);
  118. }
  119. exports.resolveAddress = resolveAddress;
  120. //# sourceMappingURL=checks.js.map